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time, get FREE overnight shipping 
when you mention this ad*. 
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From the Editor 


The big news for this month is that we've changed our name. Slightly. I bet all the readers 
who wrote us 'Why do you still have DOS in the title?' letters thought they would have no ef¬ 
fect! In fact, the title change represents no change in editorial slant whatsoever - we haven't 
run a significant percentage of DOS content in quite a long time. However, the name change 
does make the magazine's subject area clearer to prospective new readers and newsstand 
browsers. And, it lets us join the half-dozen other publications that claim to be the only publi¬ 
cation devoted completely to Windows programming! As in the past, DOS continues to reside 
under Windows (despite Microsoft claims to the contrary), and we will still from time to time 
publish articles that bump into it. ♦♦ Meanwhile, Unicode is dead. Ok, it's not really dead, 
but Windows 95 (which doesn't support Unicode) has set it back a few years. Follow my ration- 
i ale: Microsoft is pushing developers to make their Win95 executables run under NT. Within a 
j year, the NT application market will consist largely of Win95 apps that, by accident or design, 

| happen to run passably well under NT. In building a single binary to run under Win95 and NT, 
you have to decide whether to use Unicode characters internally (making the app slower and 
bigger under Win95), or ANSI (making the app slower and bigger under NT). Given the relative 
market share of the two operating systems, which character set do you think most apps will 
be using? The fact that Win95 does not support it will delay Unicode's widespread use for 3-5 
years. ♦♦ There's nothing handier than having back issues of a magazine on CD-ROM, 
for easy access. Now Programmer's Paradise is selling for $49.95 a CD-ROM with technical in- 
j formation for hundreds of products, along with back issues of Computer Language from 1989 
| to 1994. For more information, contact Programmer's Paradise, 1163 Shrewsbury Avenue, 

J Shrewsbury, NJ 07702-4321, (800) 892-1184 or (908) 389-8950; fax (908) 389-1390. ♦♦ 

Article wanted: I want an article that supplies DLL functions for vectorizing an in-memory bit¬ 
map. In other words, a .bmp to .mf converter. It doesn't have to be incredibly intelligent, but it 
should at least be able to detect and vectorize obvious lines, resulting in a much smaller repre¬ 
sentation that will react better to scaling. I'm betting some graphics guru out there can do it in 
less than 500 lines of code (not counting the usual LibMainO/UEPO stuff). ♦♦ I finally pur¬ 
chased my new machine. I kept hoping that dual-processor systems would drop to a reason¬ 
able price range, but I could finally wait no longer - I need the ability to run Windows NT and 
Windows 95 now! And I need memory - Visual C++ v2.x recommends you have 20Mb of 
j memory, and I've been about 12Mb short. Now, while I wait for the new system to arrive, 
post-purchase depression is beginning to sink in. I try to avoid seeing computer ads, so I won't 
| notice any sudden price decreases that I missed out on. ♦♦ You're reading this in Oc- 
| tober, but I'm writing it on August 24th, Windows 95 Day. What quaint customs should go 
with this new American holiday? Perhaps children should hang $20 bills in their windows in 
hopes that St. Bill will slide down the chimney and deliver a package of 'x.1' upgrades. One 
of the unfortunate side-effects of living in Redmond is that it's impossible to escape the Mi¬ 
crosoft mania (I dream of eating lunch without having to listen to people at the next table talk 
about their stock options). Bill apparently forgot to mail my invitation to the festivities, so 
rather than spending the day listening to Leno and playing carnival games, I was stuck in a de¬ 
bugger, trying to reverse-engineer Win 95 information that the (eternally non-finalized) SDK 
documentation should have told me. Such was my 'Happy Windows 95 Day", and I have a 
feeling there are many more to come. 

Ron Burk 


Editor 
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A WinG Flic Animation Player 

Ton Plooy 



Visual C++ vl .5 
Borland C++ v4.5 


Despite its two major shortcomings (no audio and a color depth limited to 
eight bits), the Autodesk Animator flic file format is a popular choice for storing 
computer-generated animation sequences. The format provides lossless com¬ 
pression - that is, compression that maintains all information from the individ¬ 
ual frames, it is surprising that systems like Video for Windows and QuickTime 
offer limited support for flic files. While both Video for Windows and Quick¬ 
Time let you integrate external compression schemes, both have unique file 
formats, that are incompatible with flic files. 

■ You could convert flic files to AVI files and write a compression codec for 
the flic file compression scheme, using Video for Windows to play the result. 
While this would let you combine the benefits of flic compression with the easy 
integration and portability of AVI files, the drawback would be that you still 
could not directly play flic files. You could instead play flic files with the 
Autodesk aaplay DLL, a flic file player that comes with a header file, library, and 
documentation. The aaplay DLL works well, but has one limitation; it displays 
an Autodesk Animation Player 'about" box for a short while. In some cases this 
is not a problem, but if you're integrating animation playing into your applica¬ 
tion, it's not a desirable feature. 

For these reasons I decided to build my own flic file player: this article pro¬ 
vides the description and source code. You can compile the source code into a 
DLL that is accessible from most languages. The source code comprises a small 
API that provides smooth flic animation in any window. The interface to the 
DLL is in flcplay.h (Listing 1); the source code to the DLL is in flcplay.c (Listing 
2); and the module definition is in flcplay.def (Listing 3). The code disk (see 
Table of Contents for availability) also contains a demonstration program (see 
Figure 1) that lets you interactively use the API to play . flc files. 


Ton Plooy is a software engineer at Commotio bv in The Netherlands, where he de¬ 
signs and develops multimedia-based Windows applications. For the past eight years 
he has been developing software for DOS, Windows, and OS/2. You may email Ton at 
tonp@xs4all.nl. 
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Listing 1 flcplay.h — Interface to flic animation DLL 


#ifndef _FLC_H 
#define _FLC_H 

#if ! defi rted(_I NC_WINDOWS) && !defined(_WIND0WS_H) 

#include <windows.h> 

#endif 

#1 fndef _FLC_C 
typedef void FAR*HFLIC; 

VAendi f 

// basic functions 

HFLIC WINAPI _export FlicCreate(void); 

int WINAPI _export FlicOpenIHFLIC Flic, const char FAR* 

FileName, HWND Window); 
int WINAPI _export FlicPlaylHFLIC Flic); 

int WINAPI _export FlicStepIHFLIC Flic); 

int WINAPI _export FlicStopIHFLIC Flic); 

int WINAPI _export FlicCloselHFLIC Flic); 

int WINAPI _export FlicDestroytHFLIC Flic); 

// informational functions 
int WINAPI _export FIiclsPlayinglHFLIC Flic); 
int WINAPI _export FlicIsClosedtHFLIC Flic); 
int WINAPI _export FIicWidth(HFLIC Flic); 

int WINAPI _export FIicHeight(HFLIC Flic); 

int WINAPI _export FlicFrameCountIHFLIC Flic); 

int WINAPI _export FIicCurrentFrameCHFLIC Flic); 

ffendif 

/* End of File */ 


Building a Flic Player 

When I began thinking about, the best way to build a 
flic player, I had just read through the WinG specifications, 
and it seemed to me that WinG would be an ideal inter¬ 
face for this purpose. The G in WinG stands for games, 
and the fact that almost all successful PC games are DOS 
programs was a major reason for Microsoft's decision to 
develop the WinG library. The great benefit of developing 
graphical application under Windows is that you don't 
have to take care of programming the specific video card 
that's being used. This also means, however, that you can¬ 
not do any direct video programming to speed up the out¬ 
put. in short, the standard Windows API for bitmap display 
and manipulation is just too slow for high-speed, graphical 
games. WinG brings improvements in several areas, but its 
most powerful feature is that it allows you to use bitmaps 
that can be output as Device Independent Bitmaps (DiBs) 
and manipulated as regular bitmaps. This means you can 
use gaming techniques such as double-buffering by keep¬ 
ing a copy of the bitmap in memory and doing all ma¬ 
nipulations directly on this copy. When the new image is 
ready for drawing, you can bitbit the complete bitmap di¬ 
rectly to the screen. 

This approach is particularly well suited to the flic file, 
because it typically uses a delta-RLE (Run Length Encoding) 
compression technique. The frame information is based 
on differences from the previous frame, and this informa¬ 
tion can be compressed with the RLE method. In fact, a 
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royalty free licensing policy. This licensing 
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Table 1 Sub-chunk types for flic files 

Subchunk Type 

Name 

File Type 

Purpose 

0x0004 

C0L0R 256 

.flc 

256-Ievel color palette 

0x0007 

DELTA.FLC 

.flc 

word-oriented delta compression 

OxOOOB 

C0L0R 64 

.fli 

64-level color palette 

0X000C 

DELTA FLI 

.fli 

byte-oriented delta compression 

OxOOOD 

BLACK 

either 

make next frame all black 

OxOOOF 

BYTE RUN 

either 

RLE-compressed frame 

0x0010 

FLLCOPY 

either 

uncompressed frame 

0x0012 

PSTAMP 

.flc 

postage-stamp sized image 


frame in a flic animation can be compressed through sev¬ 
eral different methods (such as RLE only) - or not even be 
compressed at all. However, the two most common frame 
types both use a delta-RLE type of compression. With the 
WinG API you can read the pixel changes for the new 
frame and apply them directly to the existing frame in the 
memory bitmap to construct a new one. 

The Flic File Format 

The flic file format was developed by Jim Kent, the 
author of Autodesk Animator, and was described in his 
March 1993 article in Dr. Dobb's Journal. There are actually 


two versions of the format: the origi¬ 
nal . fli format and the newer .flc 
(flic) format. The player i provide 
handles both file formats. 

A flic file consists of a header, and 
then one or more frame chunks. The 
basic idea is that each frame con¬ 
tains data that tells you how the next 
frame of animation differs from the 
previous frame of animation. In other 
words, after you construct the bitmap 
that represents the first frame, you 
read the next frame and alter the 
parts of the bitmap that have 
changed, display that on the screen, 
and then repeat the process until you 
get to the last frame. The header 
might be followed by a prefix header, a chunk that Ani¬ 
mator Pro places in the files it produces. A flic player can 
simply skip over that chunk. 

The flic format allows for continuous animation, 
whereby the first frame gets redisplayed after the last 
frame. The last frame chunk in the flic file is called a ring- 
frame, and it contains delta compressed data to construct 
the first frame from the last one. 

The 128-byte flic file header contains general informa¬ 
tion, such as the number of frames, the frame size, etc. 
The FLC_HDR structure in flcplay.c (Listing 2) describes this 
header. The header contains the width and height of the 


New: Borland Delphi! 


LEARN NOW! 


Joining our Microsoft Visual C++, Borland OWL, and 
OLE product line are two new courses in Borland’s 
exciting new Delphi Windows programming tool. We 
have a 3-day basic and 2-day advanced course in Delphi. 

&msg is a Borland Connections Training Partner. 

FIND US ONLINE! For complete class outlines, pricing, and 
schedules, look for us at: http://webmall.com/msg/msg.htm 

All courses available for onsite presentation, including customization. 


UPCOMING PUBLIC COURSES: 


C++/Win in a Week 

OWL: 

Sep 18-22 Alexandria VA 

Oct 16-20 Reston VA 

Nov 13-17 Reston VA 

Dec 4-8 Reston VA 

Visual C++: 

Sep 25 - 29 Reston VA 

Oct 9 - 13 Reston VA 

Oct 16-20 Atlanta 

Nov 27 - Dec 1 New York City 
Dec 4-8 Reston VA 


Borland Delphi 

Introductory (3 days): 

Sep 11-13 Atlanta 

Nov 27 - 29 Atlanta 

Sep 18-20 New York City 

Dec 11-13 New York City 

Oct 30 - Nov 1 Alexandria VA 

Dec 18-20 Alexandria VA 

Advanced (2 days): 

Nov 2-3 Alexandria VA 

Dec 21 - 22 Alexandria VA 


Messaging Systems Group, Inc., Suite 250, 1559 Rockville Pike, Rockville, MD 20852 


&msg 


1 - 800 - 388-3535 

In MD call (301) 230-1840 


training & consulting in object-oriented systems 


Increase your 
value in today’s 


SOLUTION PROVIDER 


Authorized Technical 
Education Center 


competitive 

Windows 

marketplace! 


• API’s instructors, with over seven years 
of Windows development and LAN 
support, are recognized by Microsoft for 
their technical and instructional 
expertise. They include Jonathan Zuck, 
Microsoft’s 1993 and 1994 Most 
Valuable Professional for Visual Basic. 

• State-of-the-art classrooms conveniently 
located in the Washington DC area 

• Discounts for group or on-site training 

AM 

(703) 518-2400 
FAX: (703) 518-8190 

Advanced Paradigms, Inc. 

1725 Duke Street, Suite 200 

Alexandria, Viginia 22314 


Please call for information on other 
Microsoft Certified training and classes. 


Microsoft Certified 
Training: 

Visual C++ • MFC 
Visual Basic • Access 

Windows NT Server 
Microsoft Mail -NT Workstation 
Systems Management Server 


Course Schedule 


Visual C++ 

Oct 2-6 

(MS #279) 

Nov 27-Dec 1 

MFC 

Sep 11 - 15 

(MS #400) 

Oct 30-Nov 3 


Dec 11 -15 

Visual Basic Introduction Oct 17-19 

(MS #273) 

Nov 20 - 22 

Visual Basic Intermediate Sep 25-29 

(MS #274) 

Nov 6-10 

Access Introduction 

Sep 5-8 

(MS #367) 

Nov 14-17 

Access Intermediate 

Oct 11 - 13 

(MS #435) 

Nov 20 - 22 


Page 10 — Windows Developer’s Journal 


□ Request Reader Service #145 □ 


October 1995 








































The 

winning 

edge 

on your 
DOS and 
Windows 
game 



The National Software Testing Lab (NSTL) can get you in great position on the 
field. For a limited lime, IBM® makes it possible for solution providers to take 
advantage of free testing of any software product available for resale to evaluate 
its compatibility with OS/2 Warp. You’ll also get free technical support through 
1996, plus publicity on the Internet! 

Call now' to schedule your free product compatibility testing. With NSTL 
coaching, the other guys won’t be able to touch you. 


With NSTL 
compatibility 
testing on 
your side, 
you’re not just 
playing, 
you’re winning. 


Look for the NSTL Tested mark on these applications: 


Adobe’s™ Acrobat™ for Workgroups 

Allen Communication, Inc.’s Quest Multimedia Authoring 

Aperture™ Technologies, Inc.’s Aperture™ 

Baker Hill Corporation’s Lending Library™ 

Baron Software Services’ Name Your Baby!™ 

Boca Soft’s Wipeout 
Boca Soft’s System Sounds for OS/2 
Competence Software’s Investment Basics 
Computer Security Consultants, Inc.’s RecoveryPAC 
DUX Software’s SimCity Classic™ 

DUX Software’s American Heritage Dictionary Concise Edition™ 

Felsina Software’s A-Talk® for Windows 

Gazelle™ Systems’ Baek-it™ for Windows 

Grolier Electronic Publishing’s 1995 Multimedia Encyclopedia 

Inteilisoft’s™ Accounting Vision/32™ 


Interplay’s™ Mario’s® Game Gallery 
Interplay’s™ Kingdom™ The Far Reaches 
Merit Studios’ Fortress of Dr. Radicki™ 

Merit Studios’ Fighter W ing™ 

Merit Studios’ Psychotron™ 

MicroDoc Products, Inc.’s Child Development Guide 
MicroLearn Nordic’s Game Pack Volume 1 
On-Line Data’s OnCmd® 

Parsons Technology’s Money Counts® 

Pinnacle Technology ’s Kid Proof/2™ 

Reed Software’s OS/2 Black Jack 
Stardoek System Inc.’s™ Star Emperor™ 

Stardock System Inc.’s™ Havoc™ 

Starpress Multimedia’s 808 Great Letters 
T/Maker’s ClickArt Newsletter Art 


AND MORE! 


Call 1-800-285-2936 

IBM and OS/2 are registered trademarks of IBM Corp. 
NSTL testing is an option of the IBM Product Compatibility Program. 

NSTL is a division of McGraw Hill Companies. 


Ready for 

°S/2.Vvr A |,f» 

NSTL Tested 


□ Request Reader Service #124 □ 










animation, which you can use to create a window of just 
the right size to contain the playback (the demonstration 
program does this). The flic file header also contains the 
offset of the first frame chunk (field duFramelOff in structure 
FLC_HDR). 

Each frame chunk starts with a 16-byte header that has 
information about the chunk length, its type, and the 
number of sub-chunks within the chunk. The structure 
CHUNK_HDR in flcplay.c (Listing 2) describes the header that 


each chunk starts with. Each frame chunk contains 
enough information (which colors or pixels have changed) 
to turn the previous frame of animation into the next 
frame of animation. This information resides in sub¬ 
chunks within the frame chunk. Table 1 lists the various 
types of sub-chunks and their purposes. 

Except for the first frame, a frame typically would not 
have more than two sub-chunks: a C0L0R_256 sub-chunk 
that specifies any color palette changes from the previous 
frame, and a DELTA_FLC sub-chunk that specifies which pix¬ 
els have changed from the previous frame. A frame with 
zero sub-chunks is identical to the previous frame, so only 
the frame delay from the file header should be applied. 

The original flic files (. fli) handled only byte-oriented 
compression types and limited the frame resolution to 
320x200. The ./7c file format introduced chunk types that 
are word-oriented and support different resolutions. Most 
flic files start with a first frame chunk that contains PSTAMP, 
C0L0R_256, and BYTE_RUN sub-chunks. After that, most 
chunks contain single DELTA_FLC or DELTA_FLI compressed 
frames (the color palette stays the same throughout a 
typical animation). My flic player does not handle the fol¬ 
lowing sub-chunk types: C0L0R_64, BLACK, LITERAL, and 
PSTAMP. These are rarely used in a flic file, but if they were 
needed, they could be implemented rather easily. 

Playing Back Frame Data 

Within flcplay.c (Listing 2), the function responsible for 
most of the interaction with the flic file is 


Dan Bricklin's® 
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FlcReadNextFrameO, which reads the next frame data. This 
function stores color information into an RGB array associ¬ 
ated with the playback and decompresses the frame data 
into the supplied buffer. These buffers are allocated when 
the playback begins; the size of the frame buffer can be 
determined from the height and width fields in the flic file 
header. (For detailed descriptions of the flic file format and 
how to decompress frames, see the references following 
this article.) 

WinG's core functionality is supplied by two functions, 
UinGCreateBitmapO and UinGBitBltO. To use those func¬ 
tions, you need to create a special WinG device context 
(DC) by calling UinGCreateDCO. When you call UinGCreate¬ 
BitmapO to "create' a bitmap, it re¬ 
turns an HBITMAP, but you still have a 
pointer to the buffer containing the 
bitmap bits. You can use that pointer 
to directly access all pixels in the bit¬ 
map. With UinGBitBltO, you can copy 
the bitmap to the screen, copying the 
bitmap bits from the WinG DC to 
your display DC. You also need to 
handle the WinG bitmap colors with 
a special function, UinGSetDIBColorT- 
ableO, since the WinG DC is not a 
standard GDI palette device. 


happens asynchronously in the context of a separate task 
makes the API a little tricky to use. Code that calls these 
functions will typically take the following form: 

// create context for playback 
HFLIC Flic = FlicCreateO; 

// playback animation file 1 
// playback animation file 2 
II ... 

FlicDestroy(Flic); 


Multitasking Playback 

The animation playback uses the 
same undocumented technique that 
Video for Windows uses to play AVI 
files. I described this technique in an 
article, The Undocumented Multime¬ 
dia Multitasking Function," in the 
March 1995 issue of W/DDJ. The ba¬ 
sic idea is that an undocumented 
function, MMTaskCreateO, spawns a 
tiny task that then calls the specified 
callback function. This function, even 
though it resides in your own appli¬ 
cation or DLL, is essentially then op¬ 
erating in the context of a separate 
task and therefore has a separate 
message queue. 

In this case, my callback function 
sits in a PeekHessageO loop, playing 
the flic file back into a window. The 
PeekHessageO loop allows other appli¬ 
cations to execute, but allows the 
calling application to process its mes¬ 
sages without any interference. This 
technique is about as close as a Win¬ 
dows 3.1 application can come to 
multithreading. 


The flcplay.dll API 

flcplay.h (Listing 1) provides the 
API to the flic player that resides in 
flcplay.dll. The fact that playback 
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In other words, FlicCreateO gives you a handle to use in 
further calls to the API, and FlicDestroyO frees up the re¬ 
sources associated with that handle. 


After you call FlicCreateO, you can call FlicOpenO to 
open a particular .flc file, passing the name of the file to 
open and the handle of the window the animation is to 
be played back in. FlicOpenO returns TRUE if it was able to 


Listing 2 flcplay.c — Source for flic animation DLL 

/* 

♦pragma warning(disable:4103) II Disable pack warning 

Borland C++ v4.5: 

♦pragma pack(l) 


bcc -DSTRICT -c -dc -ml! -WDE -vi -v flcplay.c 



tlink /v /A=16 /c /C /I Is /Twd c0dl.obj+f 1 cplay.obj.\ 

typedef BYTE huge *HPBYTE: 

f1cpl ay.d! 1,.cwl+noehwl +1mport+wlng.flcplay.def 



l'mplib flcplay.lib flcplay.dll 

♦define FLC MAGIC 

0XAF1Z 

Visual C+r vl.5: 

♦define FRAME CHUNK 

0XF1FA 

cl -DSTRICT /c /nologo /W3 Ilf /GDs /GEdme /ALw flcplay.c 

♦define COLOR 256 

4 

link /nologo /NOE /align:16 /NOD /HAP:FULL /LINE \ 

♦define DELTA FLC 

7 

f 1 cpl ay.obj... LDLLcew 1 ibw irmsystem toolhel p \ 

♦define COLOR 64 

ii 

wi ng.flcplay.def 

♦define DELTA FLI 

12 

implib flcplay.lib flcplay.dll 

♦define BUCK 

13 

*/ 

♦define BYTE RUN 

15 


♦define LITERAL 

16 

include <std1o.h> 

♦define PSTAMP 

18 

♦Include <stdlib.h> 



find tide <string.h> 

♦define FLC PAL 

0x0001 

♦include (windows.h> 

♦define FLC FRAME 

0x0002 

♦include <windowsx.h> 

♦define FLC EOF 

0x0004 

♦include <toolhelp.h> 



♦Include "wing.h" // get this from WinG SDK! 

typedef struct FLC HDR { 


DWORD dwFileSize: 


♦define _FLC_C 

WORD wMagic; 

// 0XAF12 

struct TFLIC: 

WORD wFrames; 

// Number of frames (no ring frame) 

typedef struct TFLIC *HFLIC; 

WORD wWidth; 


♦include "flcplay.h" 

WORD wHeight; 



WORD wDepth; 

// Color depth (8) 

struct TFLIC: 

WORD wFlags; 


typedef struct TFLIC *HFLIC; 
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Sub Main 

' Write Customer Names to a Text File 
Open "customer.txt" For Output As ttl 
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Print hi. Customer.Name 
Next Customer 
Close #1 
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ATX4E1V1S7=601C1 

OK 

»> Dialing S89B031 

TDTG896031 
ONNECT 9600 

>» Connecting to Compuseive Network 
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Listing 2 continued 


DWORD dwSpeed; // mSecs to delay between frames 

} TFLCFILE; 

WORD wReserved; 

DWORD dwCreation: // MS-DOS formatted date and time 

DWORD dwCreator; // Anim Pro creator number or "FLIB" 

Meflne STAT OK 8 

DWORD dvrUpdated; // Update MS-DOS date and time 

Meflne STAT PLAYING 1 

DWORD dvrUpdater; // Updater number 

Meflne STAT FILE OPEN ERR 2 

WORD wAspectX; 

Meflne STAT CREATE BM ERR 3 

WORD wAspectY; 

BYTE wUnusedl[38]; 

typedef void (CALLBACK* TASKPROCKWORD. WORD); 

DWORD dwFramelOff: 

Meflne NEW(x) ((x*)malloc(s1zeof(x))) 

DWORD dwFrame20ff; 

BYTE wUnused2[40]; // Totals 128 byes 

enum { EMPTY = 0, PLAYING = 1. STOPPED = 2, STEPPING = 3, 

1 FLCJDR; 

CLOSING = 4. CLOSED = 5 }; 

typedef struct CHUNK HDR { 

typedef struct TFLIC 

DWORD dwChunkSIze: 

( 

WORD wMagic; 

HDC hWInGDC: // Global WinG DC 

WORD wSubChunks; 

LPRGBQUAD pWinGColors; // Global color table 

BYTE wUnused[8]; 

char szFlcFile[256]; // FIc filename 

1 CHUNK HDR; 

int State; 

typedef struct DATA HDR { 

HWND Window; // non-NULL if playing 

TFLCFILE FUcFile; 

DWORD dwDataSIze; 

1 TFLIC; 

WORD wType: 

} DATAJiDR: 

typedef struct TTASK 
{ 

HWND Window; 

Mefine WIDTHBYTESt 1 ) ((WOROHd + 31) & (-31)) / 8) 

typedef struct TFLCFILE { 

TFLCFILE *FlcF11e; 

} TTASK; 

WORD wFrames; 

WORD wCurFrame; 

//.. 

WORD wWidth: 

int FlcOpentTFLCFILE ‘FlcFile, const char *szFile); 

WORD wHeight; 

int FlcReadNextFrame(TFLCFILE ‘FlcFile. LPRGBQUAD pColors, 

DWORD dwSpeed; 

HPBYTE pBits); 

WORD wWidthBytes; 

void FlcClosetTFLCFILE *FlcFile); 

HFILE fh; 

int FIcWidth(TFLCFILE ‘FlcFile); 

DWORD dwFramelOff; 

int FIcHeight(TFLCFILE *FlcFile); 

DWORD dwFrame20ff; 

DWORD FlcSpeedlTFLCFILE ‘FlcFile); 


TUB Version Control 

For DOS, OS/2 and Windows-NT 

• The experts loved TLIB 4: 

"...amazingly fast... TLIB is a great system." PC Tech Journal 

"TLIB has features and power to spare... TLIB is easy to use and 
the fastest of the reviewed packages. " Computer Language 

“I will not program without it." Uptime Magazine 

• TLIB 5.01 adds. 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 
And now... automated conversion from PVCS'“ or MKS RCS! 

• Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon NLs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Integrated with industry-leading MAKE 
from Opus" software. 

MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5-user net: DOS $419, OS/2+NT+DOS $595. Call for other sizes. 

^ ystems Software 


P0 3ox4157, Cary. NC 27519 

~ FAX: 233-0716 
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3d Graphic Tools™ 

Extending applications to new dimensions. 


• 3-D object manipulation, color drawing and rendering tools 



• For scientific, engineering, animation, multi-media, data 
visualization, CAD, CAM and 
related applications 


• 200+ DLL functions 

• 16 & 32 bit DLLs for 
Windows systems 


Fax Facts Fast (24hrs): 

Dial (800)234-0114 
Request document 1225 



Micro System Options • P.O. Box 95167 • Seattle, WA 98145-2167 
Voice (206) 868-5418 • Fax (206) 868-7780 • CompuServe 71530,2232 
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mine the size of the animation and adjust the playback 
window accordingly: 


open the . flc file successfully. At that point, the separate 
hidden task has been spawned and is waiting for your 
command to play, single-step, or stop the animation play¬ 
back. Before you start playback, you may want to deter- (continued on page 18) 



DO YOU SPEND HOURS 
TROUBLESHOOTING LANs/WANs? 

MICROSOFT WINDOWS BASED • PROTOCOL ANALYZER • LAN TROUBLESHOOTING TOOL 


Observer and Analyst/Probe are Microsoft Windows based LAN 
troubleshooting tools and protocol analyzers. With Observer or Analyst, you 
can view your LAN more clearly, see network traffic in real time and, with this 
new information, make network decisions based on facts not guesswork. 


With Observer or Analyst/Probe you can: 


SAVE HOURS OF NETWORK 

TROUBLESHOOTING TIME 

STOP the finger pointing - SIMPLY isolate 

LAN problems once and for all 

See graphical real-time long and short term 

bandwidth utilization 

Monitor statistics by station, protocol, or 

packet size distribution 

Auto-discover network addresses, auto-alias 

Novell names and TCP/IP addresses 

See packet capture decodes with pre- and 

post-header filtering (color coded packets) 

Review Ethernet and Token Ring vital sign 

displays (broadcasts, hard/soft errors, etc.) 

Set Triggers and Alarms to activate message 

windows, captures, logs, trouble tickets, or 

exec external programs 


Filter by protocol, sub-protocol, or user 
defined sequence offsets 
Detect duplicate IP addresses 
Chart TCP/IP network usage by telnet, ftp, 
NFS, and LPD/LPR 

Fully decode TCP/IP, IPX/SPX, NetBIOS, 
NetBEUI, NetBIOS over IP, and Appletalk 
Use Netware Discoverer to map your 
Netware LAN and to chart and display 
Netware specific trend statistics 
Software-only MS Windows solution - no 
additional hardware required 
Have Ethernet and Token Ring support 
Use VxD Windows drivers for NDIS and ODI 
20% the cost of comparable products 
START using the tool that professional LAN 
administrators and consultants use 




Observer 


TM 


Observer helps you quickly pinpoint network 
trouble spots, and costs thousands less than 
expensive hardware based analyzers. 

Observer Site license - $495 

FOR A SMALL SITE - $295 


NETWORK 


IH- 

COMPATIBLE 


±_p INSTRUMENTS 

Call for a FREE DEMO • 800-526-7919 

© 1995 Network Instruments, LLC 612-822-2025 FAX 612-825-5647 Internet: info@netinst.com 



Analyst/Probe 


TM 


Analyst/Probe provides Observer functionality for multi¬ 
segment LANs and/or WANs. Probes are software-only 
background Windows programs installed on each segment. 

Analyst and one Probe - $795 

Each additional Probe - $195 
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HFLIC Flic = FlicCreateO; 
if(FIicOpen(FIic, "foo.flc", Win)) 
{ 

int Width = FlicWidth(Flic); 
int Height = FlicHeight(Flic); 
// some func to set size... 
SetWindowSize(Width, Height); 

} 


After calling FlicOpen0, you can start the animation by 
calling FlicPlayO, which will play the animation in a loop 
until you call FlicStopO. Note that FlicPlayO returns im¬ 
mediately - it does not tie up your application performing 
the animation playback. FlicPlayO merely sets a flag that 
tells the hidden task it can proceed with the playback. 
Your application is free to go about its business while the 
animation plays back on its own. 


Listing 2 continued 

int WINAPI _export FlicOpenfHFLIC Flic, const char FAR* 

FileName, HWND Window) 

{ 

if(Flic 1= (!) 

{ 

1f(Flic->State != CLOSED) 

int WINAPI export FlicSteplHFLIC Flic) 

{ 

if(Flic) 

{ 

F1ic->State = STEPPING; 

return FALSE; 

return TRUE; 

strcpy(Flic->szFlcFile, FileName); 

i 

// if can't open file... 

else 

if(f1c0pen(JFlic->FlicFile, FileName) < 0) 

return FALSE; 

return FALSE; 

j 

// else we are ready to roll, spawn flic player task 
else 

{ 

static WORD Dummy; 

int WINAPI export FIicPlayCHFLIC Flic) 

{ 

if(Flic) 

Ft cCt ose(&F1ic->F1icFf t e); 

{ 

F11c->Window = Window; 

Flic->State = PLAYING; 

Flic->State = STOPPED; 

return TRUE; 

MMTaskCreatedaskCaltback. SDummy. 

) 

LOWORD(Flic), HIWORD(Flic)); 

else 

return TRUE; 

) 

return FALSE; 

} 

} 

return FALSE; 

} 

int WINAPI export FlicStoptHFLIC Flic) 

{ 


LPA-PROLOG puts 
you in the limelight! 


Build Windows 3.1 
applications that 
really shine! 
Genuine 32-bit 
applications on 
today's PCs. 



LPA-PROLOG lets you 
build them the easy way: high level 
handling of dialogs, menus, 
graphics; DLL, DDE and ODBC 
interfaces; compact, fast 
and royalty-free runtime 
system. 




Not to mention the source level 
' debugger, multi-file editor, incremental 
and optimising compilers and Prolog library. 

Let LPA-PROLOG put you in the limelight! 



Logic Programming Associates Ltd 
Phone (US Toll Free): 1-S00-949-7567 

Phone: +44 181 871 2016 - Fax: +44181 674 0449 
Email: lpa@cix.compulink.co.uk - CompuServe: 100135,134 
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II TX Text-Control 
brings true 
WYSIWYG Text 
Processing to 
your WINDOWS 
Application. 

New Version 
now available! 


Features 

Multiple fonts • Paragraph formatting • Zooming • Macrofields 
Integration of images • DLL and VBX 1.0 interface • Standard 
version: only $249 with 30 day money back guarantee 

GET YOUR FREE DEMO TODAY! 

Call 1 -800-986-6578 or 913-832-2070 
(North and South America), 

European Software Connection, 

1617 St. Andrews Drive, Lawrence, Kansas 66047, 

USA, Fax: 913 832 8787, CompuServe: 71141,3624 
Elsewhere contact 

DBS GmbH, Kohlhokerstrasse 61,28203 Bremen 
Germany, Phone: 4-49 421 33 591 -0 
Fax: 4-49 421 339 8658, CompuServe 100013,115 

Or download TXDEMO.ZIP from CompuServe 
(Forum WINSDK, section PUBLIC UTILITIES) 


DBS 
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ButtonMaker 


Includes FREE 
Balloon Control! 


d: 


lesign buttons that are completely 
unique to your application. Your 
imagination is in command. ButtonMaker 
lets you define any number of segments or 
points that will determine the button 
shape. Each segment can have a different 
shape: square, ellipse, round or straight. 

Picture Perfect Buttons! 

Multiple cells can be created for each button. Cells 
let you set background color, foreground color, 
multiple text, multiple fonts and text rotation for 
each individual portion of the button. 


Hot, Hot, Hot! 

ButtonMaker brings hot spots to you! A single button can have 
multiple hot spots that when clicked execute various commands. 
When the button is pressed you can easily program it to change 
shape, text, color and pictures. 

Up, Up and Away! 

ButtonMaker also includes a great Balloon Control. Balloons let 
you display a help bubble when the mouse pointer is over a con¬ 
trol. You have four different balloon shapes to choose from: 
round, square, ellipse and clouds. 


4174523.34254 | 
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ButtonMaker 
can be purchased direct 
from FarPoint Technologies, 
Inc., as well as a number 
of software distributors. 
ButtonMaker is royalty free 
and comes with a 30-day 
money-back guarantee.* 
To see what ButtonMaker 
can do for you, call our 
Sales Department to 
request a free demo disk. 

*Restocking Fee May Apply 


With the Button Designer, 
you can save or load 
your own templates! 



ButtonMaker provides 
predefined templates in 
many shapes that can 
be loaded with a click 
of your mouse! 

The Segment Editor 
makes changing 
segment shapes and 
sizes fast and simple. 


The calculator, phone, and remote were created entirely with ButtonMaker! 
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Listing 2 continued 


if(Flic) 

int WINAPI export FlicWidthtHFUC Flic) 

{ 

{ 

F11c->State = STOPPED; 

if(Flic) 

return TRUE; 

return FI1c->FIicFile.wWidth; 

) 

else 

else 

return 0; 

return FALSE; 

} 

int WINAPI export FlicCloseCHFLIC Flic) 

) 

int WINAPI export FlicHeightCHFLIC Flic) 

{ 

( 

if(FHc) 

1f(F11c 1= NULL) 

return Flic->F1icFile.wHeight; 

{ 

else 

Flic->State = CLOSING; 

return 8; 

return TRUE; 

) 

) 

int WINAPI export FlicFrameCount(HFLIC Flic) 

else 

{ 

return FALSE; 

if(F)ic) 

) 

return Flic->FlicFile.wFrames; 

int WINAPI export FlicIsClosedfHFLIC Flic) 

{ 

if(Flic) 

else 

return 8; 

) 

int WINAPI export FIicCurrentFrame(HFLIC Flic) 

return Flic->State == CLOSED; 

{ 

else 

if(Flic) 

return FALSE; 

return Flic->FlicF11e.wCurFrame; 

) 

else 

int WINAPI _export FlicIsPlaying(HFLIC Flic) 

return -1; 

) 

if(Flic) 

return Flic->State == PLAYING 

II F1ic->State = STEPPING; 
else 

int HandleChunkCTFLCFILE ‘FlcFile, HPBYTE pChunk, WORD wType. 

return FALSE; 

} 

LPRGBQUAD pColors, HPBYTE pFrame); 

int FIcOpen(TFLCFILE *FlcFile, const char *szFile) 


TRACK 'em DOWN! 


S.SOFFRONT* 


L CK for Windows” 



• Reduce Development Cost 

• Improve Technical Support 

• Enhance Communication 

Track: Customize: 

• Bugs, Change Requests . Reports 

• Projects, Code Changes • Queries 

• Customer Calls and more • Forms & fields 


Automatic Notification: Nothing fails through the cracks 
Integration with Version Control: Link files to bugs & bugs to files 
Multiple Linked Databases: Track bugs, customers and more 
Industry Standard Databases: Access from other applications 

FREE working DEMO! 

SOFFRONT Software, Inc. Ph 408.263.2703 

238 S. Hillview Drive, Milpitas, CA 95035 Fax 408.263.7452 

CALL 1-800-763-3766 


30 day, unconditional money-back guarantee! 
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Are you tired 
of city life? 



Do you want the 
opportunity to be part 
of a small, creative |§*4 

software team in a 
solid, financially stable 
company? The two 
desires are not mutually 
exclusive! 

Kelly Services,® a leader in 
staffing services, is adding a 
full-time programmer to develop 
training authoring systems. We’re 
located 60 miles from Lake Tahoe in the Sierra foothills. 

Our team provides Kelly's unique testing and training software for our 
1000+ offices worldwide. 

The ideal candidate will have demonstrated success creating innovative 
software and hands-on experience with C++, Borland Windows, OWL, and 
Visual Basic. A BS in C.S., Math or Business, or an equivalent combination 
of experience and expertise, is required. 

We offer competitive salary and full benefit package. Interested 
candidates may send two copies of their resume (specifying the preferred 
location) to: 


Kelly Services, Inc. 

Attn: Recruiter OLM 
999 West Big Beaver Road 
Troy, Ml 48084 SERVICES 

OTHER FULL-TIME POSITIONS IN INFORMATION SERVICES ARE 
AVAILABLE AT THE TROY, MICHIGAN, HEADQUARTERS. 

An Equal Opportunity Employer ©1995 Kelly Services, Inc. 
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In place of FlicPlayO, you can call FlicStepO to just 
advance the animation to the next frame. You may also 
find the functions FlicCurrentFrameO (which reports the 


number of the frame currently being drawn) and FlicFra- 
meCountO (which reports the total number of frames in the 
animation) useful. 


Listing 2 continued 


{ 

// Open the flc file and read the header data. 

FLC_HDR Header; 

memsettFlcFile, 0. sizeof(*F1cFlle)); 
if ((FlcFile->fh = JopentszFile, READ)) == HFILE_ERROR) 
return -1; 

_lread(FlcFile->fh, IHeader, sizeof(Header)); 
if (Header.wMagic != FIC.MAGIC) { 

J close(FlcFI1e->fh); 
return -2; 

) 

FlcFile->wFrames = Header.wFrames; 

FlcF11e->vA(idth = Header.wWidth; 

FIcFile->wHeight = Header.wHeight; 

FlcFile->dwSpeed = Header.dwSpeed ? Header.dwSpeed : 71; 
FlcFile->v#idthBytes = 

WIDTHBYTESf Header.wWidth * Header.wDepth); 

FIcFi1e->dwFramelOff = Header.dwFramelOff; 

FIcFi1e-SdwFrameZOff = Header.dwFrame20ff; 

// Prepare for reading first frame 
Jlseek(FlcFile->fh, Header.dwFramelOff, SEEK_SET); 
return 0; 


II- 

int FlcWidthtTFLCFILE ‘FlcFile) 

{ return (int)FlcF11e->wWidth: ) 

//. 

int FlcHeightlTFLCFILE ‘FlcFile) 


{ return (int)FlcFile->wHeight; ) 

//. 

DWORD FIcSpeedfTFLCFILE ‘FlcFile) 

{ return FIcFi1e-SdwSpeed; } 

//. .— 

FlcReadNextFrametTFLCFILE ‘FlcFile, LPRGBQUAD pColors, 

HPBYTE pBits) 

{ 

// Read the next frame from the flc file. The flc unit 

// is a chunk, which can consist of color info and 

// frame data. 

int rc = 0, nChunk; 

WORD 1; 

CHUNKHDR ChunkHdr; 

DATA_HDR DataHdr; 

HPBYTE pChunk; 

if (FlcFile-XwCurFrame == FIcFi1e-XwFrames) { 

// Prepare for reading first frame 
J1seek(FIcFi1e->fh, FlcFile->dwFramelOff, SEEK_SET); 
FlcFile->wCurFrame = 0; 
return FLC_E0F; 

} 

Jread(FlcFile->fh, AChunkHdr, sizeof(ChunkHdr>); 

if (ChunkHdr.wMagic != 0XF1FA) // Invalid chunk header 
return FLC_E0F; 

for (i = 0; i < ChunkHdr.wSubChunks; i++) { 

Jread<FIcFi1e->fh, SDataHdr, sizeof(DataHdr)); 



For once, bars and Windows 
can actually offer you more freedom. 


If you’re looking to create and print bar codes from within your own programs, new Bar Code 
Library for Windows loosens the shackles of application development. It supports all Windows drivers, 
all popular bar code symbologies (including PDF417), a wide variety of languages, and any application 
that can call a Dynamic Link Library. Plus, it’s royalty-free for programs 

published in less than 10,000 units. To order, contact your local reseller StrandWare 
today, or call US at 1-800-552-2331. Suggested retail $329 (USA/Canada). For Anyone Who’s Keeping Track. 

©1995 StrandWare, Inc. DOS version also available. Call 1-800-552-2331 for information. 
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Synchronizing Closure 

Stopping the animation is trickier than starting it. Once 
you call FlicPlayO, the hidden task is drawing bitmaps in 
the window you specified. If you destroy that window 
without first notifying the hidden task, disaster will ensue. 


After you stop the animation with FlicStopO, you can call 
FlicCloseO to close the .flc file and terminate the hidden 
playback task. Now comes the tricky part. 

When you call FlicCloseO, it merely sets a flag that 
tells the hidden task to terminate itself. However, the hid- 


Listing 2 continued 

pChunk = mat 1oc((unsigned)DataHdr.dwDataSize 

HPBYTE pScanLine, pScanStart; 

- sizeof(DataHdr)); 


if (pChunk = NULL) 

switch (wType) { 

return -3; 


hread(FlcFile->fh. pChunk, 

case C0L0RJ56: 

DataHdr.dwDataSize - sizeof(DataHdr)); 

wPackets = ‘(WORD _huge ‘IpChunk; 

if ((nChunk = HandleChunkCFlcFile, pChunk, 

pChunk += 2; 

DataHdr.wType. pColors, pBits)) 

for (i = 0: i < wPackets; i++) { 

== C0L0RJ56) 

cSkipCount = *pChunk++; 

rc 1= FLC PAL; 

pColors += cSkipCount; 

else if (nChunk > 8) 

wColorCount = ((cByte=*pChunk++) != ’\t’) 

rc 1= FLC FRAME; 

? cByte : 256; 

free(pChunk); 

for (j = 0: j < wColorCount; j++) { 

} 

pColors->rgbRed = *pChunk++; 

FlcFile->wCurFrame++; 

pColors->rgbGreen = *pChunk++; 
pColors->rgbBlue » ‘pChunk++; 

return rc; 

pColors-YrgbReserved = 8; 

) 

pColors++; 

} 

} 

void FlcClosetTFLCFILE ‘FlcFile) 

{ J close(FI cFit e->fh); } 

rc = wType; 
break; 

int HandleChunkiTFLCFILE ‘FlcFile, HPBYTE pCtrank, WORD wType, 


LPRGBQUAD pColors, HPBYTE pFrame) 

case BYTE RUN: // Byte run length compression 

{ 

for (i = FlcFile-YwHeight - 1; (int)i >= 8; 1-) { 

int rc = -1; 

pScanLine = pFrame; 

WORD i, j, k, wCount; 

pScanLine += 

WORD wPackets, wColorCount, wNoOfBytes, wlines, wWord; 

((DWORD)1 * (DWORD)FlcFile->wWidthBytes); 

BYTE cSkipCount, cCount, cByte, cType; 

cCount = *pChunk++; 


CLICK! 



We believe building the installation should 
never be harder than writing the application. 




Eschalon Development is proud to present 
Eschalon Setup Pro - A new addition to our 
installer family. Following in the success¬ 
ful foot-steps of EDI Install Pro, Eschalon 
Setup Pro brings you the features that 
power users crave, with the ease of use that 
the rest of us want. 

Put our expert to 
work for you! 

Don't get stuck in 
the dark ages 
with our compe¬ 
tition's shields and wizards, put our Setup 
Expert to work and charge into the 21st 
century! With the Setup Expert, building a 
complete installation is as simple as fol¬ 
lowing four easy steps - and that includes 
clicking on "Build Setup"! Within minutes 
your files are compressed and your disks 
automatically created. One click does it all! 

A standard, professional interface. 

The first thing your customer sees, is the 
installer. Eschalon 
Setup Pro's standard, 
professional inter¬ 
face makes them feel 
right at home. We 
don't clutter our 
windows with use¬ 




less gadgets or hokey graphics. A clean, 
standard interface, 
makes for a better 
product and leaves a 
lasting impression. 

Absolutely no hidden costs! 

Unlike some of our competitors, we don't 
charge royalties, and we don't require that 
you purchase a license for each product 
you distribute. Ask our competitors about 
their licenses - you'll be surprised! 

Vou'll be in good company. 

Unlike some newer products, our installers 
have been used for years by the worlds 
leading organizations. Companies like 
AT&T, Bell Canada, BP Oil, Cirrus Logic, 
DOW Chemical, 


Pi y-**__ 
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Eastman Kodak, 

Electronic Arts, 

Fannie Mae, Macromedia, Pacific Bell, Po¬ 
laroid Corp., Sprint, SunSelect, Xerox, Ziff- 
Davis Publishing, and the US Army Corps 
of Engineers. Why take chances? 

Some Eschalon Setup Pro Features: 

Standard, professional interface; 3D op¬ 
tional ♦ Dithered, tiled or bitmap back¬ 
ground ♦ Billboards ♦ Progress dialog ♦ 
Selectable components for custom setups ♦ 


Bin 
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No programming required ♦ Automatic file 
compression ♦ Ver¬ 
sion resource check¬ 
ing ♦ Disk branding 
with user name ♦ 

Auto font install ♦ Create & modify .INI 
files ♦ Create Program Manager groups & 
icons ♦ Built-in readme viewer ♦ Small 
size ♦ Support for floppy, hard disk, CD- 
ROM, Network, and e-mail distribution ♦ 
Ask about our OEM version! 

ORDER NOW FOR ONLY $149.95! 

See our evaluation versiun on our BBS, or on 
CompuServe's "WINSDK" forum, file "ESETUP.EXE". 


an 

!®[p)0imc§Gn3l> OffiXS, 


24-2979 Panorama Drive Telephone: (604) 945-3198 

Coquitlam, BC V3E 2W8 Fax and BBS: (604) 945-7602 

Canada CompuServe: 76625,1320 

VISA cards, US/Canadian checks and bank drafts accepted (order forms must accompany all 
draft orders). Sorry, no POs accepted. Canadian residents add 7% GST. BC residents add 7% 
PST. Add $10 Shipping & handling ($15 overseas), $20 for Federal Express ($45 overseas). 

All Prices are in US currency. 

For European orders, please contact: Windowshare SARL (France), voice at (+33) 
87-30-85-57, fax at (+33) 87-32-37-75, or CompuServe at 100031,3257; or BBI 
Software Gmbh (Switzerland), voice at (+41) (0) 65-271-661, fax at (+41) (0) 65- 
271-668, or CompuServe at 100120,3726. 



f schaleo Setup. Eschalon S«tMp Ptu hchuluu Setup Upeii unit the Eschalot) Development lac logo ate trademarks of Eschalon Development lac Otbei names are (registered) tiadematks ol their respective companies AH prices and specifications subject te change without notice 
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SNOWjS URFiOR WILDERNESS, OUR GROWING LINE 

• - «► 

OfcSgORTS VEHICLES CAN GO ANYWHERE. WE NEED 
AN ®FpRMAfiO^N SYSTEM THAT CAN KEEP UP.” 

Bryce D. Abrahamson, Vice President, ARCTCO, INC. 


BRYCE: “Our Arctic Cat snowmobiles and 
Tiger Shark watercraft keep us moving year 
round. Soon, we’ll have an all-terrain vehicle. 
Our growth is changing the way our business 
operates. When Ray said our information 
system had to change with it, I saw only 
giant moguls ahead." 


RAY: “With Btrieve 6, we changed to client/ 
server and had it running throughout the 
company in record time - without a hitch. 
Btrieve allows us to program in a familiar 
environment with a model we know works.” 



BRYCE:| “New information systems have a 
reputation for requiring more: more time, 
more people, more money. Ours proved just 
the opposite." 


RAY: “We've kept our staff lean and cut 
training time. We’ve reduced response time 
to two seconds and the time it takes to 
produce MRPs has been cut in half. Thanks 
to Btrieve, we are molding our system to 
meet our growing company’s needs." 


To receive the complete Arctco story, call Btrieve 
Technologies, winner of the 1995 RealWare 
Award at DB/Expo. 

fOOfJR'EVE.or u SIMPLY WORKS 

c om puserve m BTRIEVE 

[GO BTRIEVE]. ' MB TECHNOLOC3IES 
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OUR GROWTH DEMANDS CLIENT/SERVER 
TECHNOLOGY. BTRIEVE GOT US THERE 
SMOOTHLY AND ON SCHEDULE.” 


Raymond Koukari, Jr., IS Director, 
ARCTCO, INC. 











Listing 2 continued 


II Process scanline 

pScanLine += ‘pChunk+t; // Column skip 

wNoOfBytes = 8: 

cCount = *pChunk+F; 

while (wNoOfBytes < FlcFile->wWidth) { 

if ((char)cCount < 8) ( 

cCount = *pChunk++; 

cCount = -(char)cCount; 

if ((char)cCount < 8) { 

_fmemset(pScanL1ne. 

// Negative: pixel count 

‘pChunk+L (WORD)cCount); 

cCount = -(char)cCount; 

pScanLine += (WORD)cCount; 

hmemcpy(pScanLine, 

i 

pChunk, (WORD)cCount): 

else { 

pScanline += (WORD)cCount; 

hmemcpy(pScanLine, 

pChunk += cCount; 

pChunk. (WORD)cCount); 

j 

pScanLlne += (WORD)cCount; 

else { 

pChunk += cCount; 

// One pixel; repeat it cCount times 

) 

_fmemset(pScanLine, 

1 

‘pChunk++, (WORD)cCount): 


pScanLine += (WORD)cCount: 

pScanLine = pScanStart - 

) 

(0W0RD)FlcF11e->wWidthBytes; 

wNoOfBytes += (WORD)cCount; 

} 

) 

rc = wType; 

} 

break; 

rc = wType; 


break; 

case DELTA FLC; // Word sized delta compression 

case DELTA FLI: // Byte sized delta compression 

pScanline = pFrame: 

pScanline += ((DW0RD)(FlcF11e->wHeight - 1) 

pScanLine = pFrame; 

* ( DWORD ) FIcFile->wWidthBytes ) ; 

pScanline += (( DWORD )( FIcFi1e->wHeight - 1) 

wLines = ‘(WORD _huge ‘JpChunk; 

* ( DWORD ) FIcFi1e->wWidthBytes ) ; 

pChunk += 2; 

pScanLine -= ‘(WORD huge ‘JpChunk * 

for (i = 8; i < wLines; 1++) { 

(DWORD)FIcFi1e->wWidthBytes: 


pChunk += 2; 

wWord = ‘(WORD _huge ‘JpChunk; 

wLines = ‘(WORD huge ‘JpChunk; 

pChunk += 2; 

pChunk += 2; 

while ((int)wWord < 8) { 

for (i = 0; i < wLines; i++) { 


pScanStart = pScanLine; 

if (wWord A 8x4880) { // Test for bit 14 
// Line skip count 

wPackets = (WORD)*pChunk++; 

pScanLine -= ((DWORDJ-(int)wWord * 

for (j = 0: j < wPackets; j++) { 

(DWORD)FIcFi1e->wWidthBytes); 



"Visual DLL does the near-impossible, 
turning Visual Basie code into a true 
DLL. creating classes of applications 
previously beyond Visual Basics reach' 

-Windows Sources, 

July 1995 


Create Windows DLLs With 
Microsoft ® Visual Basic. 

NO C OR SDK REQUIRED! 

• Create component objects with 
Visual Basic. 

• Creates the true Windows DLL inter 
face. This means applications can 
use the DLL API interface to call 
your Visual Basic functions! 

• Split up large Visual Basic apps into 
smaller more manageable components. 


"Creating a DLL with Visual DLL is a 
surprisingly simple process. You can 
create DLL's callable from any lan¬ 
guage. It's easy, fun and fast!" 

- VB Tech Journal, 

June 1995 


• Create call-back procedures! Create 
File Manager extensions! Create 
add-on’s and Wizards! Create 

Control Panel “applets’’! 
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“One line of code... 
One click...” 

MU I EDIA 

INTEGRATE DIGITAL AND OVERLAY VIDEO, ANIMATION, AUDIO 
AND GRAPHICS IN YOUR WINDOWS APPLICATIONS 

• OLE 2.0 automation server 

• Visual Basic VBX, OCX 

• C and C++ libraries 

• integrate multimedia into any 
database 

• extended MCI device drivers (optional) 

• fastest graphics engine 

• all industry standard file formats 

• thumbnail object producer 

• capture still frames from video and 
animation 

• create “hot spots” from video, 
graphics, animation or thumbnails 

• free tech support, royalty-free 
runtime, 30 day money back guarantee 

MediaDeveloper™ 2.0 

MULTIMEDIA APPLICATION BUILDER FOR WINDOWS & NT 



le/Vel 

EL SYSTEMS WlNTBLNATH 


LENEL SYSTEMS ■ INTERNATIONAL INC 

290 Woodcliff Office Park 
Fairport, NY 14450-4212 
Fax (716) 248-9185 


CALL FOR DEMO DISK 
TODAY! 

1-800-22 LENEL 

(5 3 6 3 5) 
COMPUSERVE 71333.622 
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den task will never get a chance to execute and respond 
to that flag unless your application relinquishes control (by 
entering a message loop, for example). The crux of the 
issue here is that after you call FlicCloseO, it is still not 
safe to destroy the window you passed to FlicOpenO. The 


function FlicIsClosedO gives you an easy way to check 
whether or not the hidden task has had a chance to re¬ 
spond to the call to FlicCloseO. 

How can you let the hidden task execute after you call Flic¬ 
CloseO? You could go into a PeekMessageO loop immediately 


Listing 2 continued 

) 

*(W0RD huge ‘HpScanLine + k) = 

else ( 

‘(WORD huge ‘IpChunk; 

// Last byte of this line 

} 

cByte = (BYTEKwWord It 0X00FF); 

pScanLine += wCount; 

‘(pScanLine + 

pChunk += 2; 

( DWORD)FIcFI 1 e->wWidth - 1) = cByte: 

) 

1 

J 

pScanLine = pScanStart - 

wWord = ‘(WORD huge ‘IpChunk; 

( DWORD ) FIcFi 1 e->wWidthBytes; 

pChunk += 2; 

1 

1 

rc * wType; 


break; 

pScanStart = pScanLine; 


// Read line packets 

default; 

wPackets = Wiord; 

break; 

for (j = 8: j < wPackets; J+f) { 

) 

pScanLine += ‘pChunk+t-; // Column skip 

return rc; 

cType = *pChunk++; // Packet type 

j 

if ((char)cType > 0) { 


// Copy cType words of pixel data 


hmemcpylpScanLine, 

//. 

pChunk. (WORD)cType * 2); 

HPALETTE CreateldentPaKRGBQUAD far aRGB[]) 

pScanLine += (WORD)cType * 2; 

{ 

pChunk += (WORD)cType * 2; 

// Try to create an Identity palette from the RGBOUADs. 

} 

int 1, nStatCols; 

else ( 

HDC hDC; 

// Replicate the word -cType times 

struct { 

wCount = (WORD)-(char)cType * 2; 

WORD Version; 

for (k = 0: k < wCount; k += 2) { 

WORD NumberOfEntries; 


FIND BUGS BEFORE THEY FIND YOU! 


MemCheck 3.5 for Windows 
is Really Hot! 

Mem^/eck effortlessly detects the 
C/C++ and Windows errors that 
can drive you nuts. Automatically! 
Find improper use and leakage of Windows 
resources, handles, and GDI objects—even 
in 3rd party libraries. Find memory overwrites 
and leakage, invalid frees, stack overwrites, 
heap corruption, and other errors. 

Seek and Destroy 

MemQ/eck installs on most projects in under 
15 minutes! It's completely transparent, 

so you won't even know it's there until it 
pinpoints a problem, usually with the 
exact file and line of the error. No debug 
info required! 

Mem^eck works seamlessly with CodeView™, 
Turbo Debugger™, WinScope™, and other 
debuggers. It can even debug multiple apps 
and DLLs at the same time. Leave 
Mem^eck linked in to find problems on 
testers' machines or at client sites. When 
you're done, you can turn it off, link it out, 
or compile it completely out of your project! 


tA 

Mem&ieck 

The Finest Autcm iStlS Runtime Debugger 


Blazing Speed, More Features! 

MemCheck 3.5 for Windows now runs 10 
to 50 times faster than any other tool, allows 
project-specific settings, and supports both 
MFC and OWL. For VC++ users, there's an 
Integrator wizard to make Mem(/eck a 
seamless part of the VC++ Workbench. 

Order Today! 

You can use Mem^eck every day without 
slowing your testing to a crawl. Call 1-800- 
WE-DEBUG (that's 1-800-933-3284) now 
to get on the fast track to finding bugs! 

“A well-designedproduct... very fast... completely 
transparent... All of this flexibility combines to 
make a really fine tool... MemCheck is now part 
of my standard development process. ” 

—Windows Tech Journal, April 1995 


MemCheck Pricing: 

MEMCHECK 3.5 FOR WINDOWS . $179 

For Microsoft C/C++ (7.x-8.x, VC++) and 
Borland C/C++ (3.x-5.x) 

UPGRADE FROM 3.0 FOR WINDOWS . $59 

MEMCHECK 3.5 FOR DOS . $139 

For Microsoft C/C++ (6.x-8.x, VC++), Borland C/C++ 

(BC++ 2.x-5 x), and Watcom C/C++ (9.5 and later) 

UPGRADE FROM 3.0 FOR DOS . $49 

MEMCHECK 3.5 FOR EXTENDED DOS . 5139 

Supports Phar Lap 286\DOS Extender (MSC, BC), Borland’s 
PowerPack (DPMI 16/32), and Watcom C++ 32 (all extenders). 

UPGRADE FROM 3.0 FOR DOS . $49 

MEMCHECK FOR ANSI/K&R . $ 199 

For any UNIX, VAX, or any ANSI C or K&R projects. 

Includes full source code! An unbeatable value! 

Special Bundles!! 

fft MEMCHECK POWER PACK .... only $228 

] ] Includes MemCheck for DOS and Windows. 

J J Save $90! 

^ ' ' DOS MASTER PACK . only $188 

Includes support for real-mode and extended DOS. 
Save $90! 

A. StratosWare Corporation 

F 80 CFWMWG 

WE USE AND SHIP QUALITY RECYCLED MATERIALS 

MemCheck is a registered trademark of StratosWare Corporation. 


1756Plymouth Road,Suite 1500/AnnArbor, Ml 48105-1890• International (313)996-2944• Fax (313) 996-2955 &(313)747-8519‘CompuServe70244,1372 
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after the call. The demonstration application (see Figure 1) 
uses a less brutal method, however. It sets a timer that 
fires 10 times a second, and it uses UM_TIMER messages to 
manage the state of the animation. For example, when 


tion calls FlicCloseO and then sets a flag called Closing. 
When the dialog receives a UM_TIMER message and the 
Closing flag is set, it checks FlicIsClosedO. If FlicIsClosedO 
returns TRUE, then the application destroys the animation 


you push the 'Close' button in the dialog box, the applica- 

playback window. 

Listing 2 continued 

PALETTEENTRY aEntr1es[256]: 

} 

) Palette = { 8x388, 256 }; 

ReleaseDCtNULL, hDC); 

hOC = GetDC(NULL); 

return CreatePalette( ( L0GPALETTE *)lPalette): 

if ( GetSystemPa1etteUse ( hDC ) = SYSPALJOSTATIC) { 

} 

return NULL: 


} 

fifdef B0RLANDC 

else { 

fpragma argsused 

// For SYSPAL STATIC, only set the non-static colors 

ftendif 

nStatCols = GetDeviceCaps ( hDC. NUMRESERVED); 

void CALLBACK export TaskCal1back(W0RD a, WORD b) 

GetSystemPaletteEntries(hDC, 0. 256, 

{ 

Palette.aEntries): 

// Callback for MKTask proc. Beware: SS != DS 

// Zero the peFlags of the lower static colors 

TFLIC* TaskInfo= (TFLIC *)HAKELP(b, a); 

for (i = 0; i < (nStatCols / 2); 1++) 

HWND hWnd = TaskInfo->Window; 

Palette.aEntriesti].peFlags = 0; 

TFLCFILE* FlcFIle = JTaskInfo->FlicF11e; 


int rc = 0; 

// Set the palette entries to the DIB colors 

HDC hDC; 

for ( ; 1 < 256 - (nStatCols / 2); 1++) { 

MSG msg; 

Palette.aEntriesti].peRed = aRGB[i].rgbRed; 

HBITMAP hUinGBM, hOldBM; 

Palette.aEntries[i].peGreen = a RGB [ i ] .rgbGreen; 

HPALETTE hPal = NULL; 

Palette.aEntriesti].peBlue = aRGBti ] -rgbBl ue: 

HPBYTE pWinGBits; 

Palette.aEntriesti],peFlags = PC N0C0LLAPSE; 

DWORD dwTick; 

1 

TIMERINFO TI = { sizeof(TI), 0L, 0L } ; 

for (; i < 256 - (nStatCols / 2); i++) 


Palette.aEntriesti].peFlags = PC NOCOLLAPSE; 

// If error in opening file 


if(FlcOpen(&TaskInfo->FlicFile, TaskInfo->szFlcFile) < 0) 

// Zero the peFlags of the upper static colors 

( 

for (i = 256 - (nStatCols / 2); i < 256; 1++) 

TaskInfo->Window = 0: 

Palette.aEntriesti],peFlags = 0; 

return; 

} 
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C and C++ DOCUMENTATION 


C-METRIC™ ($59) - Complexity/Quality 

• Calculates "cyclomatic" path complexity for functions and system 

• Counts lines with comments, code, and 'C' statements 

C-CALL™ ($69) - Function Hierarchy 

•Tree-Diagram showing function hierarchy 

• Table-of-Contents of functions versus files 

• Summary and detailed cross-reference of functions 

- Function Comment 

serfs function comment blocks 
update the comment blocks 


C-LIST™ ($69) - Lists or Reformats 

• Action-Diagrams show logic/control flow 

• Reformats source to various standardized formats 


C-REF™ ($69) - Cross-References Identifiers 

• Local/global/define/parameter summary or cross-reference 

• Produces class-hierarchy tree-diagram for C++ classes 

C-BROWSE™ ($free in C-DOC) - Windows Tree Viewer 

• Graphically view C-CALL function-trees or C-REF class-trees 

C-DOC™ ($199) - DOS/Windows Package ($395 value) 

• All 5 programs integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 10,000 lines 

• Unconditional 30-day money-back guarantee of satisfaction 

C-DOC™ Professional ($299) - DOS, Windows, OS/2 

• All features of C-DOC, processes 1,000,000 lines, 3-ring binder/case 
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sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 


filel main 

file2 

— sub2 

file2 

1— sub3 

file2 

1—sub4 

filel 

— main(recursv) 


— Ibryl, Ibry2 


C-CMT™ ($69 

• Generates and ii 

• Can be re-run tc 
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definition: the ability to easily maintain your 
source code on DOS/Windows, OS/2, Windows NT 
(Alpha, MIPS, Intel) and now Windows 95 


Sf 

9 

AWARD 

1993 


The award winning MKS Toolkit is the 
#1 choice of more than 250,000 users for 
powerful cross-platform development 
tools for the PC. 

"Whether you're a programmer, administrator 
or power user, the MKS Toolkit turns Windows 
NT into a world-class operating system with 
a world-class set of commands and utilities. I 
wouldn't run ivithout it." 

—Open Computing Magazine 

The power and flexibility of MKS 
Toolkit comes not only from its sheer 
number of commands, but from its ability to combine 
these commands to perform complex programming 
tasks. Here's just a sample of what you can do with 
MKS Toolkit: 

• tar, cpio, pax, mt, and dd enable file transfer 

between operating systems and backup of your 
data to any ASPI compatible SCSI tape drive 

• the KornShell desktop tool 

performs many time saving 
functions such as command 
aliasing, command recall and 
control structures 

"MKS Toolkit is the most important 
software I own." 

—Jake Ford, Software Mechanics 
Wilsonville, OR 


MKS 

TOOLKIT 


MKS Toolkit is a registered trademark of Mortice Kern 
Systems Inc. All other trademarks acknowledged. 


• the vi editor supports both a DOS command line 
interface and a Windows graphical user interface 

• the awk programming language enables you to 
write powerful scripts and design prototypes 

• the make utility allows you to perform precise, 
uniform, repeatable builds on any platform 

The best toolset for Windows NT and Windows 95 

Now available for Windows NT 3.5 and Windows 95, 
MKS Toolkit offers native 32-bit utilities such as Vi for 
Windows; tape utilities for data transfer allowing data 
exchange between UNIX and Windows 95, and 32-bit 
Scheduler for Windows (like a Windows cron). Other 
new features include start, wcopy, wpaste, msgbox and 
filehox, vdiff, and viw for Win32. 

Once you try it, you'll see why MKS Toolkit - the 
developer's toolkit - is the ultimate choice for cross¬ 
platform development. 

Call NOW to upgrade to the Win32 version of MKS 
Toolkit - from any previous 
version - for only $99.00! 

30-day unconditional money 
back guarantee. 

1-800-265-2797 (US or Canada) 

Or: 519-884-2251 
MKS GmbH:+49 711 16714 0 
E-mail: sales@mks.com 
CompuServe: 73260,1043 
BBS: 519-884-2861 
WWW: http://www.mks.com 


toolkit 


MKS 

MORTICE KERN SYSTEMS INC. 
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Listing 2 continued 

If ((hWinGBM = WinGHdrCreateBitmap 

if (PeekMessageUmsg, NULL. 0. 0. PM REMOVE)) 

rc = FIcReadNextFrame(FlcFi le. 

(TaskInfo->hW1nGDC. FlcWidth(FlcFile), 

DispatchMessage(imsg); 

TaskInfo->pWinGColors, pWinGBits); 

FlcHeight(FlcFile), &( LPVOID)pWinGBits)) 

TimerCount(iTI); 

if (rc & FLC.PAL) { 

== NULL) { 

1f(Ta$kInfo->State == STOPPED 

III New color info, create a palette 

FlcClose(FlcFile); 

11 TaskInfo->State == CLOSING) 

if (hPal != NULL) 

return; 

continue; 

DeleteObject(hPal); 

} 

else if(TaskInfo->State == STEPPING) 

hPal=CreateIdentPal(TaskInfo->pWinGColors); 

hDC = GetDC(hWnd); 

t 

SelectPalette(hDC. hPal. FALSE); 

hOldBM = SelectObject(TaskInfo->hWinGDC, hWinGBM); 

// stop after this frame 

Real izePalette(hDC); 


TaskInfo->State = STOPPED; 

WinGSetDIBCol orTable(TaskInfo->hWinGDC, 

TimerCount(iTI); // Get start time 

// fake time so frame will be bitblted 

0, 256, TaskInfo->pWinGColors); 

dwTick = Tl.dwmsSinceStart; 

Tl.dwmsSinceStart = FlcFile->dwSpeed + dwTick; 

) 


i 

if (rc & FLC FRAME) { 

while(TaskInfo->State != CLOSING) { 

if ((Tl.dwnsSinceStart - dwTick) >= FlcFile->dwSpeed) { 

WinGBitBltChDC, 0, 0, FlcWidth(FlcFile), 


jg High-Speed xBASE 
Programmer at Work! 


Greenleaf Database 
Library 4.0 


♦ All the tools you need to create and 
manage database—complete XBASE 
ISAM package supports dBASE III, IV, V, 
FoxPro, FoxBASE, Clipper, and more 

♦ NEW Level 2 classes and functions provide 
robust, high-level capability, while Level 1 
functions give tighter control and flexibility 

♦ NEW Relational functions add power, 
versatility, and robustness 

♦ Supports Windows 95, Windows 3.lx, 
Windows NT, OS/2 Warp, MS-DOS, and 
16- and 32-bit Extended DOS —all in a 
single package; nothing more to buy! 
Supports Borland PowerPack 

♦ Unsurpassed speed and flexibility for 
access to industry standard data, index, 
and memo files at an affordable price 

♦ APIs for C, C++, with static libraries for all 
platforms, plus DLLs for Windows, 
Windows 95, and NT. Windows DLLs 
support most DLL-capable languages 
including Visual Basic 

♦ Single- and Multi-User, Network access 
fully supported 

♦ Use / access industry standard DBMS file 
formats: DBF, DBT, FPT, CDX, IDX, MDX, 
NDX, NTX, and compressed IDX 

♦ File manager dynamically configured at 
runtime—no configuration file needed 

♦ Programmer control of disk I/O cache 

♦ No limit to number of simultaneous files 

♦ Fixed & variable length memo records 

♦ Use partial & duplicate keys; automatic 
conversion between C and xBASE types 

♦ Extended field types, auto and manual 
record locks, much much more... 


Library Features 

♦ No royalties 

♦ FREE unshrouded source code 

♦ FREE unlimited phone tech support 

♦ Top-rated documentation AND online 
HELP for Windows, DOS (FREE help 
engine included) 

♦ FREE BBS access, quarterly 
newsletter 

♦ GOLD support available: toll-free 
access to BBS, tech support; FREE 
updates sent to you automatically 

♦ 30-day money-back guarantee 


‘S' Call today for complete infor¬ 
mation, demo, or to order. 
MasterCard, VISA, AmEx and 
Novus; approved purchase orders. 

1 -800-523-9830 


(214)248-2561 
FAX: (214)248-7830 
BBS: (214)250-3778 
email: info@gleaf.com 
Web: http://www.gleaf.com/-gleaf 
CompuServe: go greenleaf 

Greenleaf Software, Inc. 
16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 


ffl 

GREENLEAF 
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Using Windows timers works well 
in this situation for a couple of rea¬ 
sons. First, UM_TIMER is about the low¬ 
est priority message there is, so even 
setting a 10-per-second timer will not 
cause any discernible slowdown in 
the user interface. Second, because 
UM_TIMER is such a low priority, by the 
time you receive it the odds are good 
that the hidden application either has 
gotten a chance to run, or will get a 
chance right away. 

Notes on Palette Management 

Handling palettes has never been 
easy, and using WinG makes it even 
more difficult. If you create a palette 
for a bitmap, it is called a logical pal¬ 
ette, while the internal hardware pal¬ 
ette is called the system palette. 
When the logical palette is used, it 
will be mapped to the system palette 
by the palette manager. A logical pal¬ 
ette that is identical to the system 
palette is called an identity palette, 
and it can speed up bitblt operations 
considerably because no mapping 
needs to be done. 

The palette created by flcplay.dll 
is an identity palette in most, but not 
all, cases. One reason for this is that 
flic color palettes without the system 
static colors, or with static colors out¬ 
side the default static palette entries, 
will not generate identity palettes. 
Creating an identity palette for every 
possible input is a difficult job and 
could entail setting the system static 
colors to different values. Windows 
uses these colors (normally, there will 
be 20 static palette entries) to draw 
the standard windows attributes, 
such as caption bars, borders, scroll 
bars, etc. It's a good practice to gen¬ 
erate a well though-out palette for 
your flic file, a palette that at least 
includes the system static colors. If, 
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Listing 2 continued 

n cHelght ( n cFI 1 e).Tasklnfo->hWinGDC .0.0); 

//. 

i 

HBITMAP WinGHdrCreateBitmap(HDC hWinGDC, 

dwTick = Tl.dwmsSinceStart; 

Int nWidth, int nHeight, void FAR * FAR *ppBits) 

j 

else { 

struct { 

// Could do pre-read frame here 

BITMAPINFOHEADER Header; 

i 

RGBQUAD aColors[256]; 

i 

} BmHdr; 

SelectObject(TaskInfo->hWinGDC. hOldBM); 

if(WinGRecornnendDIBFormatt(LPBITMAPINFO)iBmHdr) == 0) 

DeleteObject(hWinGBM); // and delete it 

return NULL; 

if (hPal 1= NULL) 

// Create the WinG bitmap, make sure it’s 8 bpp 

DeleteObjectthPal ) ; // Remove the palette 

BmHdr.Header.biBitCount = 8; 

FlcClose(FlcFile); // Close the flc file 

BmHdr.Header.biCompression = BI RGB; 

ReleaseDCthWnd, hDC); // Don’t forget 

BmHdr.Header.biWidth = nWidth; 


BmHdr.Header.biHeight * nHeight; 

TaskInfo->State = CLOSED; 

return WinGCreateBitmap(hWinGDC, 

return; 

(LPBITMAPINFO)iBmHdr, ppBits); 


/* End of File */ 


for one reason or another, you really 
have to use all 256 colors without in¬ 
cluding the static colors, be sure to 
read the Microsoft technical article 
'The Palette Manager How and 
Why,' by Ron Gery, first. The WinG 
documentation does have some 
good information on this subject, but 
the provided sample code (which I 
used as the basis for my palette crea¬ 
tion function) has some omissions. 


Summary 

Optimizing the code for the 
DELTA_FLC sub-chunk decompression 
would improve the speed of the flic 
file player. Because of the word-size 
orientation, this should be done in 
assembly language, possibly with 32- 
bit code (take a look at the 
fast32.asm sample provided with the 
WinG SDK to see how to accomplish 
this). New frames could also be pre- 
processed in the TaskCallbackO loop 
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Let’s face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 

mov dx,offset int 17h entry 

int 21 h : 

mov dx,offset data_4 
mov ah,9 
int 21 h 


mov dx,19h 
mov ah,31h 
int 


endp 


DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

: DOS Services ah=function 09h 
; display char string at ds:dx 


: DOS Services ah=function 31 h 
; terminate and stay resident 
; al=retum code.dx=paragraphs 


int_17h_entry proc far 
pushf 

emp al,3Fh 


; Push flags 


Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C. C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can’t change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_l 0_video". Andit'sfully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs. DLLs, VxDs. device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls. 
API calls like ’’GetModuleHandle", undocu¬ 
mented APIs. VxD functions and much more. 

Call now! 

1 ’ 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6: Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
W_ San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 
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Listing 3 flcplay.def — Module definition file for 
flcplay.dll 


LIBRARY flcplay 

DESCRIPTION 'flcplay.dll - library to play .flc files via WinG' 
EXETYPE WINDOWS 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE SINGLE 

HEAPSIZE 4096 

EXPORTS 

WEP @1 RESIDENTNAME 


when the current frame is still within its time limit. 

The WinG library is a perfect match for handling video 
jobs such as flic file animations, since building and dis¬ 
playing the frames becomes much easier (and faster) than 
with the traditional GDI DIB functions, if you don't have 
the WinG SDK, you can download it from Microsoft's ftp 
site (ftp.microsoft.con), where you can find it in the /de- 
velopr/drg/UinG directory. The SDK also includes the run¬ 
time libraries you'll need to install on your Windows 3.1 
or Windows 95 system. Note that WinG was developed 
primarily for 16-bit Windows applications. If you want to 
develop 32-bit WinG applications for Windows 95 or Win¬ 
dows NT, you should use CreateDIB- 
SectionO, which has the same func¬ 
tionality. 


Add ZylNDEX full-text 
retrieval technology to 
your application. 

ZylNDEX is the most powerful full-text 
search technology available. The result of 
11 years' of R&D and market experience. 
ZylNDEX is the performance leader in: 

• Search Query Speed 

• Query Power 

• Index Storage Efficiency 

• Document Format Support 



Index 


Your Application 


Files ito be 
Indexed 


Z ylNDEX 

Developer's Toolkit 
In U.S. 1-800-894-6602 
In Europe 011 (31)20-696-6277 


The ZylNDEX Toolkit 
High-level Application 
Programming Interface 
(HAPI) is specially 
designed for easy, fast 
implementation. Ideal 
for use with popular 
high-level authoring 
environments such as 
Visual Basic. 

ZylNDEX is the top- 
rated text retrieval 
application, and has led 
the market since 1984. 
Now, your application 
can take advantage of 
advanced full-text 
retrieval technology 
from ZyLAB. 


Query Constructs: 

• word 

• phrase 

• wildcards 

• proximity 

• delimited search 

• quorum 

• file name 

• file date 

• numeric range 

• Boolean operators 

• unrestricted nest 

• concepts 

• field search 

• progressive search 

Fuzzy Searching 

Overcomes ambiguities 
such as misspellings 
that can result from 
OCR limitations. 


Pricing 

Standard Toolkit:$3995 
Fuzzy Search Version:$4995 
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Automatic Scaling for MFC 

Brad Pirtle 



Many Windows applications need the ability to arbitrarily scale, or zoom, the 
contents of a window. An example of this is "Print Preview," where you can 
zoom in or out on a portion of the printed page. Proper scaling in Microsoft 
Windows requires you to set the mapping mode, window extent, window ori¬ 
gin, viewport extent, and viewport origin for a window. In this article I explain 
how to easily use the built-in scaling capabilities of Windows, and I apply those 
capabilities to a C++ MFC extension class that I call CZoomView. 

To understand how a drawing page can be automatically scaled in a win¬ 
dow, you must understand, first, how to draw the page, and, second, how to 
view the page. The Windows operating system uses both pieces of information 
together so that a user can view your drawing in a window at any arbitrary 
zooming scale. As a programmer, your best approach to scaling is to 'divide 
and conquer," that is, handle each concept separately. 


Brad Pirtle is a Windows C++ Development Consultant in San Jose, CA, specializing in 
user interface programming. He can be reached via CompuServe at 72260,1152, and 
via the Internet at brad@cinemasoftware.com. 
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Listing 1 zoombase.h — Declaration of CZoomBase 


// zoombase.h : 

virtual void OnPrepareDC(CDC* pDC, 

// Implements Zooming functions in a CScrollView window 
// Written by Brad Pirtle 

CPrintlnfo* plnfo = NULL); 

// CS:72450,1156. Internet:pirtle@qlogic.com 

// Operations 

// Version 1.0 

public: 

fifndef ZOOMBASE H 

// Overridden CScrollView meirber functions 

#define ZOOMBASE.H 

void SetZoomSizesISIZE sizeTotal, 

const SIZES sizePage = sizeDefault, 

//////////////////////////////////////////////////////////// 

const SIZES sizeLine = sizeDefault): 

// CZoomView view 

void Center-OnLogicalPointCCPoInt ptCenter); 

class CZoomBase : public CScrollView 

I 

DECLARE DYNAMIC(CZoomBase) 

CPoint GetLogica I CenterPoint ( void): 

// Zooming functions 

protected: 

int DoZoomln (CRect Srect); 

CZoomBaseO : CScrollViewO, m_zoomScale(l.0) {}; 

int DoZoomln (CPoint ‘point = NULL, float delta * 1.25); 


The SQL DBMS of choice for 
developers who want scalability, 
interoperability and price/performance 




Quadbase-SQL is the only industrial-strength, ANSI SQL 89 DBMS that allows 
you to develop and deploy your applications in stand-alone environments such 
as individual notebooks or desktops as well as in LAN environments, 
including both peer-to-peer and client/server configurations. 

Quadbase-SQL for Windows can support your stand-alone applications 
as well as workgroup, multi-user applications on a network without a 
dedicated server. It can run on any DOS/Windows-compatible 

network. Network independence and ease-of-use allow 
your applications to operate in a potentially large 
installation base. 

Quadbase-SQL Server offers true client/server 
functionalities. Running under NetWare and 
Windows NT, it fully utilizes the multi-threading 
capabilities of the operating systems. Asynchronous 
I/O is supported for optimum performance. It is SMP- 
ready under Windows NT. 



For interoperability, an ODBC level 2 driver is included to serve as a native API to the 

Quadbase engine. The lack of complicated API 
mapping and intermediate data buffering/' 
translation further enhances its performance. 

Prices start at $100. Don’t allow our 
extremely attractive pricing to throw you 
for a loop. Quadbase-SQL offers many 
of the advanced functionalities found 
(and not found!) in its higher-priced 
competition. Key advanced features include bidirec¬ 
tional scroll cursors, multiple BLOB fields per table, declarative referential integrity 
with triggers and SQL-2-compliant multi-table outer joins 


Quadbase-SQL is 
the DBMS that 
you can count on 
to build your 
most demanding 
applications. 


Please call 408-982-0835for a free demo disk or 
to receive instructions on where and how to 
download the demo immediately on-line. 

■n Quadbase Systems, Inc. 

■ I 2855 Kifer Road, Suite 203, Santa Clara, CA 95051 
Tel: 408-982-0835 • Fax: 408-982-0838 
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Step One: Drawing the Page 

The first thing to do is choose the 
'logical units' for your drawing. You 
can think of these as the number of 
virtual horizontal and vertical units 
on the page you will draw on. Win¬ 
dows calls the area defined by these 
units the 'window extent," and it is 
set by SetVindowExtO. A logical page 
size of x by y units would simply 
have a window extent of (x,y). Keep 
in mind that 'units' is an arbitrary 
measure that you select - so you are 
not limited to pixels, inches, or any 
other specific measure. For example, 

HDC hDc = GetDC(hWnd); 

SetWindowExtthDc, 100, 100); 

sets the extent of the given window 
to 100 by 100 logical units, no mat¬ 
ter what the actual pixel dimensions 
of the window are. 

Once you choose a logical coordi¬ 
nate system, all GDI drawing is based 
on it. For example, say that you want 
to draw a line from the top left cor¬ 
ner to the bottom right corner of a 
page that has a window extent of 
100 by 100 logical units. Continuing 
the previous code fragment, you 
would add the following calls; 

MoveTo(hDc, 0, 0); 

LineTo(hDc, 100, 100); 

This would draw a line from the up¬ 
per left corner of the window to the 
lower right corner, no matter what 
the actual pixel dimensions of the 
window. Any other Windows graph¬ 
ics function (Rectangle!), ArcO, Create- 
FontO, TextOutO, etc.) will also use 
logical units. Windows translates the 
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Listing 1 continued 


int DoZoomOut (CPoint *point = NULL, float delta = 1.25): 

CPoint ^remainder); 

int DoZoomFullO; 

void CalcBars(void); 

// Override this to get notified of zoom scale change 

// Private member variables 

void NotffyZoom(void) 0; 

CSize m origTotalDev; // Origional total size 

// Zooming utility functions 

CSize m_origPage[)ev; // Origional per page scroll size 

CSize m origLineDev; // Origional per line scroll size 

void ViewDPtoLP (LPPOINT lpPoints, int nCount » 1); 

float m zoomScale; 

void ViewLPtoDP (LPPOINT lpPoints, int nCount = 1); 

}: 

void ClientToOevicetCPoint &point): 

//////////////////////////////////////////////////////////// 

void NormalizeRect (CRect Srect); 

#endif 

private: 

// Internally called functions 

void PersistRatio(const CSize iorig, CSize &dest. 

/* End of File */ 


logical coordinates into pixel coordi¬ 
nates when it draws. 

Using logical units gives your pro¬ 
gram display device independence. 
Drawing objects coordinates can all 
be stored in logical units, and you 
can use those coordinates to paint 
your windows without having to con¬ 
vert for scaling, different screen size, 
or different window size. Device-de- 
pendent conversions and resoving 
which part of the drawing to scale 
and display in the window will be 
handled automatically by Windows 
after you follow the next step. 

Step 2: Viewing the Page 

The second part of adding auto¬ 
matic scaling to your program is to 
define how the page will be viewed 
in a window. Viewing functionality 
uses device coordinates, in pixel 
units, so you need to tell Windows 
the viewing size, in pixels, of your 
entire drawing page. Windows calls 
this region the 'viewport extent,' and 
it is set by SetVieuportExtO. Setting 
the viewport extent does not confine 
a real window to that size, but rather 
describes the mapping of your logical 
units into pixels. By setting a window 
extent to (100,100) and a viewport 
extent to (200,200), you tell Windows 
that 100 by 100 logical units is ex¬ 
actly equal to 200 by 200 pixels. Fig¬ 
ure 1 shows the relationship between 
the actual window and the viewport. 
To help in translating back and forth 
from logical to device units, Windows 
supplies LPtoDPO to convert logical to 
device units, and DPtoLPO to convert 
back. 

When you set window and view¬ 
port extents, you are required to 
change the mapping mode, which is 


tri SERIAL I/O 


The ONLY Serial Communication Libraries, DLLs, & Tools You Will Ever 
Need For Windows (3.0, NT & 95) & MSDOS. Accept No Less Than The Best!! 


COMM-DRV/DOS™ 


Supported By All Products 

• Unlimited number of ports active concurrently. 

• Hardware/Software Flow Control. 

• 8250/16450/16550 Auto detection/Up to 115200 baud. 

• Remap baud rates/Change baud rate divisor. 

• 100% Port re-entrant code(lmportant for multitasking) 

• Support for several intelligent & all dumb multiport cards 
(Amet, Digiboard, Boca, GTEK, AST, & more). 

• Product Customization. 


COMM-DRV/LEB™ 

Professional Serial I/O Libraries & DLLs 
for WINDOWS & MSDOS 

• Supports ALL languages, tools, or applica¬ 
tions that can call the Windows API. 

• Complete source code to all libraries. On 
line help. 

• Same API for Windows or MSDOS. 

• High level Hayes compatible modem sup¬ 
port. 

• X, Y, & Zmodem on multiple ports concur¬ 
rently. 

• ANSI/BIOS screen management utility. 

• Asynchronous & timed callback to user functions on 
different serial communication eventsfmodem signals, 
buffer count, character reception, and much more). 

• Supports Quickbasic, Visual BasicfDOS&Windows), ANSI 
C/C++, Visual C/C++, Assembly. 

• Transmit data from user callback on any event(lmportant 
for multidrop applications). 

• Extensive scanning of input character stream. 


COMM-DRV/LIB.S189.95 

COMM-DRV/DOS.S99.95 

COMM-DRV/WIN.S99.95 

COMM-DRV/V xD(I ntroductory Offer).S99.95 

4PortMultiportCard(16450).SI 10.00 

4PortMultiportCard(16550A).S170.00 

8 Port Multiport Card( 16550A).$225.00 

SoftwareCombo(Lib,VxD,Dos,Win)~.$399.95 

Complete Com bo(Sftwe+4Portw/l 6550) ....-...$499.95 


MS-DOS Serial I/O TSRs & Utilities 

• True DOS device driver that allows serial ports to be 
opened as normal files under MS-DOS or Windows. 

• TSR to redirect serial data to keyboard buffer, transpar¬ 
ent to user application(Great for barcode & POS apps). 

• Provides FOSSIL interface for all supported cards(BBS 
operators). 

• Provides INT14H , INT21H, & DAM interfaces. 

• Compatible with Desqview and Win¬ 
dows. 

• Real time serial port monitoring to 
screen and disk. 

• Mini-BBS for file transfer/Spawnable 
stand-alone file transfer engine. 

COMM-DRV/WIN™ 

Windows Replacement Serial 
Communications Driver 

• True Windows comm device replace¬ 
ment. Use your favorite Windows com¬ 
munication applications on all multi- 

port cards we support. 

• Allow the use of more than 9 serial ports under 
Windows by allowing users to remap any serial port on 
the fly. 

COMM-DRV/VxD™ 

High Performance Serial I/O VxD For Windows 

• Windows DLLs with API calls into the 32 bit VxD. 

• MSDOS libraries for calling VxD from a DOS box. 

• Handles all serial communication interrupts at ring zero 
and in 32 bit mode. 

• Automatic detection of 16550 UARTs and uses both 
the transmit and receive FIFOs. 

• May be called from Windows & MS-DOS concurrently. 

• Baud rates up to 115.2K baud under Windows!!! 

• Integrates seamlessly with all COMM-DRV products. 



wese 


2470 S. Dairy Ashford Suite 188, 
Houston, TX 77077 

1-800-966-4832 713-498-4832 

(Fax) 713-568-3334, BBS 713-568-6401 
Internet: sales@wcscnet.com 
WWW: http://www.wcscnet.com/home.htm 
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The Ultimate Grid™ Control! 


Communication Centei 


pspn i 


Load) 



Type 

Date 

Name 

Print 

Priority 


1 

M 

02/12/95 

Adam Seibel 

Print Now 

Urgent 

2 

J 

2 

w 

02/12/95 

Craig High 

✓ 

Low 


3 

w 

02/13/95 

Dave Cunningham 

i/ 

Normal 


A 


02/14/95 

Doug Keller 

Print Now : 

Urgent 


5 

ED 

02/18/95 

Andrew Whitman 

✓ 

Urgent 


6 

w 

02/21/95 

Ed Chong 

✓ 

Normal 
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ps*i 

02/24/95 

Julie Ind 

✓ 

Low 


8 

ED 

03/01/95 

Joe MacIntyre 

Print Now 

Urgent 


9 


03/05/95 

Laurie Hay 

Print Now 

Normal 


10 

ED 

03/05/95 

Troy Marchand 

✓ 

Normal 


11 

ED 

03/11/95 

Lorraine Weiler 

Print Now 

Normal 


12 

Hk 

lfc/1^95 

Victor Lau 

✓ 

Urgent 




Company 

Contact 

Phune 


Athletic Addiction 

MacIntyre. James 

(418)965-2100 £ 


Dewey Decimal 

Price. Laura 

(705)742-9786 



Great Kid Productions 

Marchand. Donna 

(212)464-7283 



Marine Engineering 

Ind. Graeme 

(456)253-8124 



Media Research 

Cunningham. Chris 

(212)463-6453 



Papyrus 

Mersereau.Lou 

(416)232-9875 



Planned Leisure 

Degagne. Ron 

(607)343-2391 


y s* 

Quickie Cuts 

Ardiel. Shawna 

(705)743-7345 


T © 

Sewrite Manufacturing 

Lefebvre. Lisa 

(412)653-5282 


1 El 

Timberland Adventures 

Gordon. Brad 

(673)455-1324 

♦ 


V Uses Dynamic data loading. Ultimate Grid(tm) only retrieves data when 
needed. Providing maximum performance and minimal memory usage, 
even when the data source has millions of records. 

From one to over 2 Billion records in the table (without any performance 
loss). No bound control can say that! 

V View and edit anything that you want, from any data source. Our control 
lets you stay in charge, you can integrate it with any data source you 
wish. Integrates databases (standard or proprietary), arrays, calculated 
fields, text files or any other source easily. 

V 


and much more. 

An extensive amount of information is passed from the grid through its 
notification messages. This allows the behaviour of the grid to be easily 
enhanced or restricted. 

Extend the grid’s capabilities! The grid was designed so that its existing 
capabilities can be enhanced or new ones can be added. Even the 
grid’s edit control comes with a complete API, which allows it to be 
enhanced or replaced by another edit control. 

Intelligent disk caching. Ultimate Grid contains an advanced virtual 
memory algorithm to boost performance to it’s maximum. 

Includes hundreds of lines of usable demonstration code, so you can 
get started right away! Demostrates all messages and functions. 

Great for: Database viewers, list boxes, spreadsheets, mailing lists, 
invoicing and much much more. 

V Includes both 16 and 32 bit DLLs 
. Pricing: DLL $149 / Source $349 


Customer Database 


Record 12576/284506 jl 


Search Party™ - The Ultimate File Finder 

Super fast and flexible file finding API. Find the exact files that you want in record time. 

Full Featured: Long filenames, search for more than one file at a time (TIF, GIF, PCX, JPG, BMP, 
WMF all at once.) 

V Search by date, time, name, size, or any combination. 

V And if we didn't say it before (it’s really, really fast!) 

V Includes both 16 and 32 bit DLLs 

V Pricing: DLL $79 / Source $199 


Search For j 
Available Drives: 


j~ Start Search [ 
4 | Advanced ] 


File Name Date 

Site 

Path 

S£ DAVE EXE 

11/14/94 

56563 

C:\ 

3 DAYORG.HLP 

07/25/92 

154034 

E:\DAY 

S DEBUG WRI 

03/22/90 

16423 

C:\PROG\HELP 

B* DEFRAG.EXE 

02/1 7/95 

97465 

0\UTILI7Y\DISK 

S DEPLOY WRI 

06/14/91 

78436 

C:\PLAN\INFO 

S DERIVE WRI 

01/25/95 

21007 

C:\W1NDOWS\DOC 

3 DEVELOP HLP 

05/11/95 

74565 

D:\INFO\HELP 

3 DEVICE HLP 

02/03/95 

62756 

C:\WORKHW\DEV 


File Search Completed 


Matches 123 of 13492 


The Ultimate Border Control 


TM 


V Multi-purpose border/text control. Make your applications more consistent, portable, and more 
attractive with an appealing 3D look and enhanced text. 

V Includes more than 20 border styles, including raised, recessed, gutter, bump. Select colors, 
brushes, fonts. 

Built in functions to automatically give any control a 3D look. Easily enhance any custom control 
not just the standard windows controls. 

V Also includes a professional status/progress bar. 

Includes both 16 and 32 bit DLLs 

7 Pricing: DLL FREE / Souce $79 


DUNDAS 


SOFTWARE 


dundas@dundas.com 
Sales: (800)463-1492 
Voice: (416) 239-7472 
Fax: (416)239-2183 


60 Day Money back guarantee. If you don't think these products 
are the best in their class, we will gladly give you your money back. 

V Call Today! Visa, Amex, cheque or money order. 

V We will deliver via internet, CompuServe, mail or courier. 

V The prices shown are in U.S. dollars. 


202-4800 Dundas Street West 
Etobicoke, Ontario M9A1B1 


240 Portage Rd., Suite 670 
Lewiston, NY 14092 


Flat 
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Actual Window 


set by SetMapModeO. With SetUindowEx- 
tentO and SetViewportExtentO, only 
two mapping modes are allowed - 
m_IS0TR0PIC and MM_ANIS0TR0PIC. 

MMJSOTROPIC mode is used when you 
want identical logical units for both 
the x and y axes, while MM_ANIS0TR0PIC 
is used for arbitrary logical x and y 
axis units. For the generic scaling re¬ 
quirements of CZoomZiew, i will use the 
MM_ANISOTROPIC map mode. 

The final piece of information that 
Windows needs for automatic scaling 
is the size (also in pixels) of the client 
area of the physical window that will 
display your drawing. Because this in¬ 
formation is inherent in the window, 
no API call is necessary. The size in 
pixels of the window's client area de¬ 
termines how many pixels of the 
viewport will be shown. For example, 
setting the viewport extent to be the 
same number of pixels as the client 
area of the window would scale the 
entire logical drawing to fit the win¬ 
dow. Setting the viewport extent to 
twice the size of the window's client 
area would make the user see one- 
fourth (half the width and half the 
height) of the page, and the drawing would appear larger 
(or "zoomed in'). 

The viewport extent is where you control the scaling 
factor for a window. To zoom in, increase its size and re¬ 
draw. To zoom out, decrease its size and redraw. It really 
is that easy! To maintain the original width-to-height ratio 
of your logical drawing, always set the viewport extent to 
the same ratio as the window extent, and scale it the 
same in both the x and y direction. 

A Quick Scrolling Primer 

Once a window has the ability to scale, zooming in 
shows only a portion of the entire drawing. By adding 
scrolling to the window, you can let the user view the 
entire drawing without having to zoom back out. MFC 
supplies a scrolling class, called CScrollView, which encap¬ 
sulates all the necessary Windows scrolling code. For SDK 
users and those of you who don't want to read the 700+ 
lines of code in CScrollView, I will briefly explain the scroll¬ 
ing concepts used with automatic scaling. 

To set up scrolling, you use SetViewportOrgO to manipu¬ 
late the viewport origin. This is the viewport's origin in 
relation to your window's origin. Because I am scaling by 
manipulating the viewport only, I keep the window origin 
(set with SetMindowOrgO) at (0,0). A good way to visualize 
origin manipulation for scrolling is to think of your draw¬ 
ing as a transparency, and the window in which it will be 
displayed as an overhead projector. The upper left corner 
of the transparency is the viewport origin, and the upper 
left corner of the projector is your window's origin (always 
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Figure 1 Relationship of the viewport to the actual window 


(-10,-10) Viewport origin 



(. 2x,2y ) 


Logical Drawing 


Client { x,y } 
rect 


Viewport 
extent 
in pixels 


TWAIN Integration Kit" 

The TWAIN Integration Kit for Windows applications supports 
this and hundreds of other scanners. It is easy, fast and power¬ 
ful. No ofher scan or imaging toolkit provides this many TWAIN 
functions. Simple - if you want, complex - if you need. Standard 
and Professional versions available. 16 bif and 32 bit versions 
available. TWAIN support for your Windows application in a day 
or less - no problem with the TWAIN Integration Kit. 



Cal! now! 

North and South America: 
European Software Connection 
1617 St. Andrews Drive- 
Lawrence. KS 66047 
Phone: 800-986-6578 
or 913-832-2070 

Fax: 913-832-8787 . 

CompuServe 71141,3634 


Free demo available y 
CompuServe. Download TIKDHM.ZlfJ 
from WINSDK forum, section Public Utilities. 


ELSEWHERE: 

JUAIGCLAUS SOFTWARE ENGINEERIlie 

P.O. Box 270 202 
40525 Duesseldorf 
Germany 

Phone: +49 211 504 84 79 
Fax: -49 211562 3112 

CompuServe 100334,2207 
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(0,0)). If the transparency is too big to be seen all at once 
(zoomed in), you need to move it with your hand (scroll) 
to see all of it. To see more to the right, you slide the 
paper to the left. To see more below, you slide the paper 
up. 


Applying this metaphor to Windows, to scroll n pixels 
in a given direction, change the viewport origin n pixels in 
the opposite direction. For example, if you started with 
both origins at (0,0) and wanted to scroll 10 pixels to the 
right and 10 pixels down, simply set the viewport origin to 
(- 10 ,- 10 ). 




Figure 2 Before and after zoom in 



Add Graphs, Dialog Boxes and 
Clipboard support to your DOS 
applications. 


Integrate Your DOS Applications 
With Windows Usin~ 


Extend your 
DOS 

applications 
and integrate 
them with 
Windows 
applications. 

We support 
Clipper, FoxPro, 
dBase, C/C + +, 
Basic and Batch 
files. 



JJ PORTABLE 
J J SOFTWARE k 

P.O. Box 675573 Marietta, GA 30067 
404-952-2432 FAX 404-955-1375 


1-800-484-2045 x 3000 

From DOS 


$59 
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Listing 2 zoombase.cpp — Implementation of 
CZoombase 


// zoombase.cpp : 

// Implements Zooming functions in a CScrollView window 
// Written by Brad Pirtle 

II CS:72450.1156, Internet:pirtle@qlogic.com 

// Version 1.0 

//include "stdafx.h" 

#include "zoombase.h" 

IMPLEMENT_DYNAMIC(CZoomBase, CScrollView) 

//////////////////////////////////////////////////////////// 
// CZoomBase overridden default CScrollView members 
//////////////////////////////////////////////////////////// 

/*.. . 

FUNCTION: SetZoomSizes 

PURPOSE : Set up the CZoomBase class with the logical 
page size, and scrolling page/line units. 

This replaces CScrol1 View::SetScrol1 Sizes. 

*/ 

void CZoomBase::SetZoomSizes ( 

SIZE sizeTotal, 

const SIZES sizePage, // in logical units 
const SIZES sizeLine) // in logical units 

{ 

// Set up the defaults 

ASSERT(sizeTotal.cx >= 0 SS sizeTotal.cy >= 0): 
m_nMapMode = MFLANISOTROPIC; // For arbitrary scaling 

m_totalLog = sizeTotal; 

// Setup default Viewport extent to be conversion of 
// Window extent into device units. 

//BLOCK for DC 

{ 

CWindowDC dc(NULL); 
dc.SetMapMode(m_nMapMode); 

// total size 

m_totalDev = m_totalLog; 

dc. LPtoDPI (LPPOINT)Sm_total Dev); 

} // Release DC here 

// Save the origional Viewport Extent 
m_origTotalDev = m_totalDev; 

// Save the origional scrollbar info - for CalcBars 
m_origPageDev = sizePage; 
m_origLineDev = sizeLine; 

// Fugure out scroll bar info 
CalcBarsO; 

// Notify the class that the zoom scale was set 
NotifyZoomO; 

} // SetZoomSizes 

/* . . . 

FUNCTION: OnPrepareDC 

PURPOSE : Override of CScrollView for MM.ANISOTROPIC 

*/ 

void CZoomBase::OnPrepareDC ( 

CDC* pDC, 

CPrintlnfo* plnfo) 

{ 

#ifdef _DEBUG 

if (mjMapMode != MM_ANISOTROPIC) { 

TRACE0C"Error: must call SetZoomSizes()\n"); 
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Listing 2 continued 


ASSERTtFALSE); 

) else { 

return; 

// Special case for printing 

} 

CSize printSize; 

tfendif //JEBUG 

printSize.cx = pDC->GetDeviceCaps(HORZRES); 

ASSERTJALID(pDC); 

printSize.cy = pDC->GetDeviceCaps ( VERTRES ) ; 

// Maintain the origional ratio, setup origin shift 

ASSERT(m_totalLog.cx >= 0 M m_totalLog.cy >= 0); 

PersistRatio(m totalLog, printSize, ptVpOrg); 

ASSERT(m_totalDev.cx >= 0 M m_totalDev.cx >= 0); 

// Zoom completely out 

// Set the Mapping mode, the window and viewpont extents 

pDC->SetViewportExt(printSize); 

pDC->SetMapMode(mjiMapMode); 

) 

pDC->SetWindowExt(m_totalLog); // logical coordinates 

// Set the new origin 

CPoint ptVpOrg; 

pDC->SetViewportOrg(ptVpOrg); 

if (!pDC->IsPrinting()) { 

// For default Printing behavior 

CView::OnPrepareDCtpDC, plnfo); 

pDC->SetViewportExt(m_totalDev); // device coordinates 

) // OnPrepareDC 

// by default shift viewport origin in 

/* . 

// negative direction of scroll 

FUNCTION: CalcBars 

ASSERT ( pDC->GetWi ndowOrgt ) == CPolnt(M)); 

PURPOSE : Update the scrollbars - uses logical units 

ptVpOrg = -GetDeviceScrollPositionO; 

Call when the Viewport changes size. 

. */ 

void CZoomBase::CalcBars (void) 

// Center full fit 

if (m bCenter) { 

{ 

CRect rect; 

{ // BLOCK for DC 

GetClientRect(Srect); 

CWindowDC dc(NULL); 

// if client area is larger than total device size, 

// override scroll positions to place origin such 

dc.SetMapMode(m_nMapMode); 

// Calculate new device units for scrollbar 

// that output is centered in the window 

// Start w / origional logical units from SetScrollPos 

if (m_totalDev.cx < rect.WidthO) 

m pageDev = m origPageDev; 

ptVpOrg.x = (rect.WidthO - m_totalDev.cx) / 2; 

dc.LPtoDPt ( LPPOINT)ta_pageDev); 

if (m_totalDev.cy < rect.Height!)) 

m lineDev = m origLineDev; 

ptVpOrg.y = (rect.HeightO - m totalDev.cy) / 2; 

dc.LPtoDP((LPP0INT)&m lineDev); 

} 

} // Free DC 
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ETN Press announces The Visual Basic/Multimedia Primer, the 
new book in the Heng Tan Visual Basic Programming Series. Heng 
Tan guides you through Visual Basic 4, OLE Control, Windows API 
calls, WinG, Medialib, Multimedia Viewer, VBA, OLE Servers, 
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and Windows 95. Macromedia Director, Adobe Photoshop, Adobe 
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Delphi, C + + and 
Borland Pascal 
Script Language 


Enhance your applications with a powerful 
and easy to use script language 

• Small footprint • Easy to use • Easy to extend 

• Implemented as an object hierarchy to provide 
application specific functionality and as a DLL 

• Link directly to Delphi applications, no DLLs, VBXs 

• Use in Windows from Delphi, C++ or Borland Pascal 
applications, and in DOS from Borland Pascal real and 
protected mode applications. 

Get PASTERP for $200, $800 with source. 
NO ROYALTY! 





Price does not include S&H. 


P.O.Box 5517, Coralville, IA52241, USA. 
TeleFax. (319) 351-8413. CompuServe 76350.333 
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Adding Zoom to MFC 

I have encapsulated the scaling concepts discussed 
above into two MFC extension class: CZoomBase and CZoow- 
View. CZoomBase is declared in zoombase.h (Listing 1) and im¬ 
plemented in zoombase.cpp (Listing 2). CZoomVieu is declared 


Listing 2 continued 


in zoomview.h (Listing 3) and implemented in zoomview.cpp 
(Listing 4). The CZoomBase class encapsulates all the base 
zooming functionality, and is derived from the MFC class 
CScrollView. It could just as easily be done using straight 
SDK C code, but then you would have to write your own 


// Make sure of the range 

if (m_pageDev.cy < 0) m_pageDev.cy = -m_pageDev.cy; 
if (mJineDev.cy < 0) mJineDev.cy = -mJineDev.cy; 

// If none specified - use one tenth 
ASSERT(m_totalDev.cx >= 0 U m_totalDev.cy >= 0); 
if (m_pageDev.cx == 0) m_pageDev.cx = m_totalDev.cx / 10 

if (m_pageDev.cy == 0) m_pageDev.cy = m_totalDev.cy / 10 

if (mJineDev.cx == 0) mJineDev.cx = m_pageDev.cx / 10 

if (mJineDev.cy == 0) mJineDev.cy = m_pageDev.cy / 10 

// Now update the scrollbars 
if (mJiWnd != NULL) { 

UpdateBarsO; 

Invalidate(TRUE); // Zoom scale changed, redraw all 

} 

} // CalcBars 

//////////////////////////////////////////////////////////// 
// CZoomBase custom members to implement zoom functionality 
//////////////////////////////////////////////////////////// 

/* 

FUNCTION: DoZoomln 

PURPOSE : Zoom the view in on a rect 

... */ 



Add LIFE to your applications with 
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Development Kit 


• Live interactive demo • Traditional slide-show demo 

• Live interactive tutorial • AVI/BMP - captured demo 
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int CZoomBase::DoZoomIn ( 

CRect Jrect) // rect in logical coordinates 

{ 

ASSERT(m_nMapMode == MM_ANIS0TR0PIC); 

// Screen pixels apart for region zoom 
const int PICKMARGIN = 10; 

// Make sure that the rect is normalized 
CRect zoomRect = rect; 

NormalizeRect(zoomRect); 

// Get the center of rect 
CPoint ptCenter; 

ptCenter.x = ((zoomRect.left + zoomRect.right) / 2); 
ptCenter.y = ((zoomRect.top + zoomRect.bottom) / 2); 

// See if the rect is small enough for a point zoom 
// in Device coordinates) 

CRect rectDP = zoomRect; 

ViewLPtoDPt(LPPOINT)JrectDP, 2); 

BOOL bPointZoom = (maxtrectDP.WidthO, rectDP.HeightO) < 
PICKMARGIN): 

if (bPointZoom) { 

// Just do normal point zoom 
return DoZoomlnUptCenter): 

} 

CRect clientRect; 

GetClientRect(&clientRect); 


// Calculate the new zoom scale, 
float scaleH = (float) (clientRect.right + 1) / 
(float) zoomRect.Width!); 
float sealeV = (float) (clientRect.bottom + 1) / 
(float) zoomRect.HeightO; 

// Keep the scale Isotropic 
m_zoomScale = mintscaleH, scaleV); 


// Modify the Viewport extent 

m_totalDev.cx = (int) ((float) m_origTotalDev.cx * 

m_zoomScale); 

m_totalDev.cy = (int) ((float) m_origTotalDev.cy * 

m_zoomScale); 


CalcBarsO; 


// Set the current center point. 

CenterOnLogical Point(ptCenter); 

// Notify the class that a new zoom scale was done 

NotifyZoomO; 

return TRUE; 

} // DoZoomln (Rect) 

/*.. ... 

FUNCTION: DoZoomln 

PURPOSE : Zoom in on a point by the scale factor 

.*/ 

int CZoomBase::DoZoomIn ( 

CPoint *point, // point in logical coordinates 

float delta) // scale factor 

{ 

CPoint ptCenter; 

ASSERT(m_nMapMode == MM_ANIS0TR0PIC); 

// Save the current center point, 
if (Ipoint) { 

ptCenter = GetLogicalCenterPointO; 

} else { 

ptCenter = *point; 
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DOS or 
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client/server applications, the last thing you need is an 
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through your daily development tasks, 
an editing environment which is cus- 1 
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locking, multi-user configuration, and MAPI/MS-Mail inte¬ 
gration is also included. And when juggling numerous pro¬ 
jects, Multi-Edit's session manager will save your entire edit¬ 
ing sessions as menu items to be called upon at a later time. 
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scrolling code. The CZoomView class encapsulates the user 
interface functionality, and is derived from the CZoomBase 
class. 

There are three requirements for using my zoom 
classes: derive your view from CZoomView, set the logical 
units using CZoomView::SetZoomSizes(), and do ail drawing 
in your OnDrawO member function (like the UM_PAINT mes¬ 
sage) in terms of your logical units. The classes handle all 
the scaling and scrolling for you. 

How CZoomBase Works 

You must set the map mode, window extent, viewport 
extent, and viewport origin for each device context handle 
(HOC) you use. The correct place for this kind of preparation 
is in the MFC CView: :OnPrepareDC() member function, and 
this is where CZoomBase sets up everything. To control the 
scaling, CZoomBase keeps track of the window extent in the 
m_totalLog member variable, and the viewport extent in 
the m_ totalDev member variable. In CZoomBase: :0n- 
PrepareDCO, the map mode is set to MM_ANISOTROPIC and the 
window and viewport extents are set using the appropri¬ 
ate member variable. If your derived class needs to do 
some processing during this function, make sure you call 
CZoomBase::OnPrepareDCO first. 

Zooming is handled by keeping track of the current 
zoom scale (starting at 1.0) in the m_zoomScale member 
variable. To change the viewport extent for a given zoom 
scale, the original viewport extent (stored in m_origTotal- 
Dev) is multiplied by the m_zoomScale 
variable. To zoom in (using the Do- 
ZoomlnO member function), the zoom 
scale is multiplied by a constant, 
which defaults to 1.25. This increases 
the size of the viewport extent, mak¬ 
ing the drawing appear larger or 
'zoomed in." To zoom out (using the 
DoZoomOutO member function), the 
zoom scale is divided by the same 
constant. This decreases the viewport 
extent, making the drawing appear 
smaller or "zoomed out.' 

Binding Zooming to the 
User Interface 

I designed CZoomView to be flexible. 
Proper zooming requires a user inter¬ 
face that would feel comfortable to 
users. I wrote three types of zooming 
into CZoomView. default zooming, point 
zooming, and selection zooming, all 
of which are described below. The 
three methods are demonstrated in 
the sample program supplied on the 
code disk (see Figure 2). 

Default zooming is where the cur¬ 
rent view is zoomed in or out by a 
small constant ratio, maintaining the 
same center reference point. This 
could be triggered by a user pressing 
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Pixel Translations 


A Cornerstone Imaging Company 
408 985 6600 FAX 985 5600 
internet: info@pixtran.com 

The Standard for Imaging Tools 


Listing 2 continued 


} 

// Increase the zoom scale. 
m_zoomScale *= delta; 

// Modify the Viewport extent 

m_totalDev.cx = tint) {(float) m_origTotalDev.cx * 

m_zoomScale); 

m_totalDev.cy = tint) ((float) m_origTotalDev.cy * 

m_zoomScale); 

CalcBarsO; 

// Set the current center point. 

CenterOnLogicalPoint(ptCenter); 

// Notify the class that a new zoom scale was done 

NotifyZoomO; 

return TRUE; 

} // DoZoomln (Pt) 

/*. 

FUNCTION: DoZoomOut 

PURPOSE : Zoom out on a point by a scale factor 

| .. */ 

I int CZoomBase::DoZoomOut ( 

CPoint *point, // point in logical coordinates 

float delta) // scale factor 

j { 

I CPoint ptCenter; 

ASSERT(m_nMapMode == MM„ANIS0TR0PIC); 

// Save the current center point, 
if (! poi nt) { 

ptCenter = GetLogi cal CenterPoi nt(); 
i } else { 

ptCenter = *point; 
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Listing 2 continued 


} 

// Decrease the zoom scale. 
m_zoomScale /= delta; 

// Modify the Viewport extent 

m_totalDev.cx = (int) ((float) m_origTotalDev.cx * 

m_zoomScale); 

m_totalDev.cy = (int) ((float) m_origTotalDev.cy * 

m_zoomScale); 

CalcBars(); 

// Set the current center point (logical coordinates. 
CenterOnLogicalPoint(ptCenter); 

// Notify the class that a new zoom scale was done 

NotifyZoomO; 

return TRUE; 

} // DoZoomOut 

/* 

FUNCTION: DoZoomFull 

PURPOSE : Zoom the view to full state 

.*/ 

int CZoomBase::DoZoomFul 1 (void) 

{ 

ASSERT(m_nMapMode == MM_ANI$0TR0PIC); 

CRect rc; 

CPoint pt; 

CSize sizeSb; 

// Just set Viewport Extent to Client size for full fit 
GetTrueClientSize(m_totalDev. sizeSb); 

// Maintain origional ratio 

PersistRatio(m_totalLog, m_totalDev, pt); 

// Set the new zoom scale (could use cx or cy) 
m_zoomScale = (float) m_totalDev.cx / m_origTotalDev.cx; 
// Remove the scrollbars 
UpdateBarsO; 

// Complete redraw 
Invalidate(TRUE); 

// Notify the class that a new zoom scale was done 

NotifyZoomO; 

return TRUE; 

} // DoZoomlnFul 1 


FUNCTION: CenterOnLogica1Point 
PURPOSE : Same as CScrollView::CenterOnPoint, 
but for logical coordinates 

. */ 

void CZoomBase::CenterOnLogicalPoint(CPoint pt) 

{ 

// Convert the point to device coordinates 
ViewLPtoDP(Spt); 

// Account for scroll bar position 
ClientToDevice(pt); 

// Use CScrollView’s function for device coordinates 
CScrollView::CenterOnPoint(pt); 

) // CenterOnLogicalPoint 

/*. 

FUNCTION: GetLogicalCenterPoint 

PURPOSE : Get the center of screen in logical coordinates 

*/ 

CPoint CZoomBase::GetLogicalCenterPoint (void) 

{ 

CPoint pt; 

CRect rect; 

// Get the center of screen 
GetClientRect(&rect); 
pt.x = (rect.Width!) / 2); 
pt.y = (rect.Height!) / 2); 

// Convert the point to logical coordinates 

ViewDPtoLP(Spt); 

return pt; 

} // GetLogical CenterPoint 


/*. 

FUNCTION: ViewDPtoLP 

PURPOSE : Same as DPtoLP, using the ClientDC for the view 

. *1 

void CZoomBase::ViewDPtoLP ( 

LPPOINT IpPoints, 
int nCount) 

{ 

// Convert to logical units 
// Called from View when no DC is available 
ASSERT(m_nMapMode >0); // must be set 
CWindowDC dc(this); 

OnPrepareDC(Sdc); 
dc.DPtoLPdpPoints, nCount); 

} // ViewDPtoLP 

/*. 

FUNCTION: ViewLPtoDP 

PURPOSE : Same as LPtoDP. using the ClientDC for the view 

. .*/ 

void CZoomBase::ViewLPtoDP ( 

LPPOINT IpPoints, 
int nCount) 

{ 

// Convert to logical units 
// Called from View when no DC is available 
ASSERT(m_nMapMode > 0); // must be set 
CWindowDC dc(this); 

OnPrepareDCt&dc); 
dc.LPtoDPOpPoints, nCount); 

} // ViewLPtoDP 
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Device Drivers Revealed 


Writing Windows VxDs 

and Device Drivers 

by Karen Hazzah 

A Practical Guide to: 

■ Simple Device Drivers 
for Non-Standard Devices 
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Windows Virtual Machines 


Windows Application Interfaces 
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device drivers—without wasting your time in arcane API trivia! 
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■ Write an interrupt-driven driver, also in C, for better 
performance and throughput than the basic polled-mode 
driver. 

■ Write a VxD driver, a high-performance solution that also 

provides an interface for both Windows and DOS 
applications. . 
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programs. 
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a function key, where, say, F7 zooms in and F8 zooms 
out, or by toolbar buttons. To implement this from within 
the class, call the DoZoomlnO and DoZoomOutO member func¬ 
tions with no arguments. 

Point zooming is where the current view is zoomed in 
or out, again by a small constant ratio, centering on a 
given reference point. This is best applied to a mouse, 


Listing 2 continued 


I*— . 

FUNCTION: ClientToDevice 
PURPOSE : Convert from Client coordinates to 
relative Device coordinates 

.*/ 

void CZoomBase::ClientToDevice ( 

CPoint &point) 

{ 

// Need to account for scrollbar position 
CPoint scrollPt = GetDeviceScrollPositionf); 
point.x += scrollPt.x; 
point.y += scrollPt.y; 

} // ClientToDevi ce 

/*. 

FUNCTION: NormalizeRect 
PURPOSE : Normalize the rectangle 

.*/ 

void CZoomBase::NormalizeRect ( 

CRect Srect) 

{ 

if (rect.left > rect.right) { 
int r = rect.right; 
rect.right = rect.left; 
rect.left = r; 

} 

if (rect.top > rect.bottom) { 
int b = rect.bottom; 
rect.bottom = rect.top; 
rect.top = b; 

} 

} // NormalizeRect 
/* 

FUNCTION: PersistRatio 

PURPOSE : Hake a CSize maintain the given ratio 
(by shrinking if nescessary) 

.-.*/ 

void CZoomBase::PersistRatio ( 
const CSize Mrig, 

CSize Mest, 

CPoint Remainder) 

{ 

float ratiol = (float) orig.cx / orig.cy; 

float ratio2 * (float) dest.cx / dest.cy; 

int newSize; 

// Do nothing if they are the same 

if (ratiol > ratio2) { 

// Shrink hieght 

newSize = (int)(dest.cx / ratiol); 
remainder.x = 0; 

remainder.y = dest.cy - newSize; 
dest.cy = newSize; 

} else if (ratio2 > ratiol) { 

// Shrink width 

newSize = (int)(dest.cy * ratiol); 
remainder.x = dest.cx - newSize; 
remainder.y = 0; 
dest.cx = newSize; 

} 

} // PersistRatio 
// End of File 


Listing 3 zoomview.h — Declaration of 
CZoomView 


// zoomview.h : header file 

// Implements Zooming functions in a CScrollView window 
// 

// Written by Brad Pirtle, 

II C$:72450,1156, Internet:pirtle@qlogic.com 
// Version 1.0 
#ifndef ZOOMVIEW.H 
tfdefine ZOOMVIEW.H 

include "zoombase.h" 

//////////////////////////////////////////////////////////// 
// CZoomView view 

class CZoomView : public CZoomBase 
{ 

DEC LARE.DV NAMIC(CZoomView) 

protected: 

CZoomViewO; 
virtual -CZoomViewO; 

#ifdef .DEBUG 

virtual void AssertValid() const; 

#endi f //.DEBUG 

public: 

// Zooming modes 
typedef enum 

{M0DE.Z00M0FF, M0DE.Z00MIN, M0DE.Z00M0UT) ZoomMode.; 
void SetZoomModetZoomMode. zoomMode); 

ZoomMode. GetZoomMode() {return m.zoomMode;}; 

// Zoom drawing functions 

void DrawBoxtCDC Me, CRect &rect, BOOL xor = TRUE); 
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Listing 3 zoomview.h — Declaration of 
CZoomView 


void DrawLine(CDC &dc, const int &xl. const int &yl, 

const int &x2, const int &y2, 

BOOL xor = TRUE); 

private: 

// Private member variables 
ZoomMode_ m.zoomMode; 

BOOL m_bCaptured; 

CRect m_ptDragRect; 

HCURSOR m.hZoomCursor; 

public: 

// Generated message map functions 
//{{AFX_MSG(CZoomView) 

afx_msg void OnLButtonDown(UINT nFlags, CPoint point); 
afx_msg void OnLButtonUpiUINT nFlags, CPoint point); 
afx_msg void OnMouseMoveiUINT nFlags. CPoint point); 
afxjnsg void OnRButtonDown(UINT nFlags, CPoint point); 
afxjnsg BOOL OnSetCursoriCWnd* pWnd, UINT nHitTest, 

UINT message); 

//}}AFX_MSG 
DECLARE_HESSAGE_MAP() 


VAendi f 

/* End of File */ 


Listing 4 zoomview.cpp — Implementation of 
CZoomView 


// zoomview.cpp : 

// Implements Zooming functions in a CScrollView window 
// 

// Written by Brad Pirtle, 

// CS:72450,1156, Internet:pirtle@qlogic.com 
// Version 1.0 

#include "stdafx.h" 

#include "zoomview.h" 

//include "resource.h" // For CURSORS 

BEGIN_MES$AGE_MAP(CZoomView, CZoomBase) 

//{{AFX_HSG_MAP(CZoomView) 

ON_WM_LBUTTONDOWN() 

ON_WM_LBUTTONUP() 

ON_WM_HOUSEMOVE() 

ON_WM_RBUTTONDOWN() 

0 N_WM_S ETCU RSOR() 

//}}AFX_MSG_MAP 
END_MESSAGE_MAP() 

IMPLEMENTJYNAMICtCZoomView, CZoomBase) 

/* 

FUNCTION; CZoomView 

PURPOSE : Constructor for the CZoomView class 

.*/ 

CZoomView:; CZoomViewO 
: CZoomBaseO 
{ 

// Init zoom mode to nothing 
m_zoomMode = MODE_ZOOMOFF; 

m_bCaptured = FALSE; 

m.ptDragRect. SetRectEmpty (); 

// Load the zoom cursor 

m.hZoomCursor = :: LoadCursor(AfxGetlnstanceHandle(), 
MAKEINTRESOURCE(IDCJOOMCURSOR)); 

} // CZoomView 

/*... . 

FUNCTION: -CZoomView 

PURPOSE : Destructor for the CZoomView class 


Listing 4 continued 


.*/ 

CZoomView::~CZoomView() 

{ 

// Clean up the cursors if they were loaded properly 
if (m_hZoomCursor) DestroyCursor(m_hZoomCursor); 

} // -CZoomView 

/*--. 

FUNCTION: AssertValid 
PURPOSE : Make sure valid class 

. */ 

#ifdef .DEBUG 

void CZoomView::AssertValid() const 

{ 

// Bypass CScrollView because of MM.ANISOTROPIC map mode 
CView::AssertValid(); 

} // AssertValid 
#endif //.DEBUG 

//////////////////////////////////////////////////////////// 
// CZoomView custom members to implement zoom functionality 
//////////////////////////////////////////////////////////// 

I* 

FUNCTION: SetZoomMode 

PURPOSE : Put the view into the specified zoom mode 

.*/ 

void CZoomView;:SetZoomMode ( 

ZoomMode. zoomMode) 

{ 

ASSERT(m_nMapMode == MM.ANISOTROPIC); 
if (zoomMode != m.zoomMode) { 
m.zoomMode = zoomMode; 

// Force cursor change now 
OnSetCursor(NULL, HTCLIENT, 0); 

} 

} // SetZoomMode 


/*. 

FUNCTION: DrawBox 

PURPOSE : Draw a box - XOR if want to erase 

.*/ 

void CZoomView::DrawBox ( 

CDC 4dc, 

CRect Srect, 

BOOL xor) 

{ 

CPen pen; 

// Save the device context 

dc.SaveDCO; 

if (xor) { 

dc.SetR0P2(R2_N0TX0RPEN); 

// 0 width = 1 device unit 
pen.CreatePenCPS.DASH, 0, RGB(0, 0, 0)); 

} else { 

// 0 width = 1 device unit 
pen.CreatePentPS.SOLID. 0, RGB(0, 0, 0)); 

} 

dc.SelectObject(&pen); 

// Draw the rect with lines (eliminate rect middle fill) 

dc. MoveTo(rect. left, rect.top); 

dc.LineTo(rect.right, rect.top); 

dc.LineTofrect.right, rect.bottom); 

dc.LineTotrect.left, rect.bottom); 

dc.LineTo(rect.left, rect.top); 

// Clean up 
dc.RestoreDCt-1); 

) // DrawBox 

/* 

FUNCTION: DrawLine 

PURPOSE : Draw a line - XOR to erase 
.*/ 
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where the user selects whether to zoom in or out from a 
key combination or toolbar button, then clicks with the 
mouse on the view where the zoom should occur. To im¬ 
plement this from within the class, call the DoZoomlnO and 


DoZoomOutO member functions with a logical CPoint for the 
new center point. 

Selection zooming, which applies only to zooming in, is 
where a specific region of the logical drawing is made to 
fit within the window. The best way to implement this is 


Listing 4 continued 


void CZoomView::DrawLine ( 

CDC &dc, 

const int &xl, // Logical units 
const int &yl, 
const int &x2, 
const int &y2, 

BOOL xor) 

{ 

CPen pen; 

// Save the device context 

dc.SaveDCO; 

if (xor) { 

dc.SetR0P2(R2_N0TX0RPEN); 

// 0 width = 1 device unit 
pen.CreatePen(PS_DASH, 0, RGB(0, 0, 0)); 

) else { 

// 0 width = 1 device unit 

pen.CreatePen(PS_S0LID. 0. RGB(0, 0, 0)); 

} 

dc.SelectObjectUpen); 

// Draw the line 
dc.MoveTotxl, yl); 
dc.LineTo(x2, y2); 

// Clean up 
dc.RestoreDC(-l); 

} // DrawLine 

/*. 

FUNCTION: OnLButtonDown 

PURPOSE ; Handle the left mouse click 

. */ 

void CZoomView::OnLButtonDown( 

UINT nFlags, 

CPoint point) 

{ 

// Pass the message along 
CZoomBase::OnLButtonDown(nFlag$, point): 

switch (m_zoomMode) { 
case M0DE_Z00MIN: 

// Capture the mouse for zooming in 
m_bCaptured = TRUE; 

SetCaptureO; 

// Save the mouse down point for XOR rect 
ViewDPtoLPUpoint); 

m_ptDragRect.SetRect(point.x, point.y, 

point.x, point.y); 

// Set the cursor to the cross hair 
::SetCursor(::LoadCursor(NULL, 

MAKEINTRESOURCEtIDC_CR0SS))); 
break; 

default: 

// Do nothing, 
break; 

} 

} // OnLButtonDown 

/*. 

FUNCTION: OnMouseMove 

PURPOSE : Handle the mouse movement 

. */ 

void CZoomView::OnMouseHove(UINT nFlags, CPoint point) 

{ 

// Pass the message along 


CZoomBase::OnMouseMove(nFlags, point); 

if (m_bCaptured) { 

// Get the Device Context 
CClientDC dc(this): 

OnPrepareDC(idc); 

switch (m_zoomMode) { 
case M0DE_Z00MIN: 

// Draw the drag-rect 
// Erase last rect 
DrawBox(dc, m_ptDragRect); 

// Draw new rect 

dc.DPtoLP(Spoint); 

m_ptDragRect.BottomRi ght() = point; 

DrawBoxtdc, m_ptDragRect); 

break; 

default: 

// Do nothing, 
break; 

} 

) 

) // OnMouseMove 
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to have the user select zoom in via a key press or toolbar 
button, then drag a box with the mouse to indicate the 
region that should be zoomed to fit the window. To imple¬ 
ment this from within the class, call the DoZoomlnO mem¬ 
ber function with a logical CRect for the region to fit into 
the window. This type of zooming requires special consid¬ 
erations. Since users will probably select an abnormally 
sized region, the class forces the region to the correct win¬ 
dow extent ratio by shrinking either the width or the 
height of the region if necessary. Figures 2a and 2b dem¬ 
onstrate this process. 


Wrapping It All Up 

Adding scaling or zooming capabilities to a Windows 
program is fairly straightforward if you know which Win¬ 
dows functions to use, and how to use them. This article 
has described the necessary APIs and outlined the steps 
you must take to add automatic scaling to your own pro¬ 
gram. Using the C++ classes provided here makes the 
task very easy, and requires as few as three steps. How¬ 
ever, applying this to a straight C SDK program would be 
just as straightforward. Three methods of zoom interac¬ 
tions with the user are implemented in an example pro¬ 
gram written in MFC, also supplied with this article. Don't 
be scared by the manuals, add automatic scaling easily to 
your program today! □ 


Listing 4 continued 


/* . 

FUNCTION: OnlButtonUp 

PURPOSE : Handle the left mouse release 

.... */ 

void CZoomView::OnLButtonUp ( 

UINT nFlags, 

CPoint point) 

{ 

// Pass the message along 
CZoomBase::OnLButtonUp(nFlags, point); 

switch (m_zoomMode) { 
case M0DE_Z00MIN: 

// Uncapture the mouse? 
if (m_bCaptured) { 
m_bCaptured = FALSE; 

ReleaseCaptureO; 

// Set back the cross cursor to the Z 
::SetCursor(m_hZoomCursor); 

// Get the Device Context 
CClientDC dc(this); 

OnPrepareDCt&dc); 

// Erase the bounding box 
DrawBoxidc, m_ptDragRect); 

// Now Zoom in on logical rectangle 
DoZoomIn(m_ptDragRect); 

} 

break; 

case M0DE_Z00M0UT: 

ViewDPtoLPt&point); 

DoZoomOutt&point); 

break; 

default: 

// Do nothing, 
break; 

} 

} // OnLButtonUp 

/*. 

FUNCTION: OnRButtonDown 

PURPOSE : Handle the right mouse click 

CANCELS CURRENT ZOOM MODE OR DRAG 

.*/ 

void CZoomView::OnRButtonDown(UINT nFlags, CPoint point) 

{ 

CZoomBase::OnRButtonDown(nFlags, point); 

// See if currently captured 
if (m_bCaptured) { 


// Maintain current mode, just stop current drag 
m_bCaptured = FALSE; 

ReleaseCaptureO; 

// Get the Device Context 
CClientDC dc(this); 

OnPrepareDCt&dc); 

switch (m_zoomMode) { 
case MODE_ZOOMIN: 

// Erase last rect 
DrawBoxidc, m_ptDragRect); 
break; 

default: 

// Do nothing, 
break; 

} 

} else { 

// Cancel current mode 
m_zoomMode = M0DE_Z00M0FF; 

} 

} // OnRButtonDown 
/* 

FUNCTION: OnSetCursor 

PURPOSE : Set the cursor depending on the zoom mode 

*/ 

BOOL CZoomView::OnSetCursor ( 

CWnd* pWnd, 

UINT nHitTest, 

UINT message) 

{ 

if (nHitTest != HTCLIENT) 

return CZoomBase::OnSetCursor(pWnd, nHitTest, message); 

switch (m_zoomMode) { 
case M0DE_Z00M0FF: 

: -.SetCursorC::LoadCursorCNULL, IDC_ARR0W)); 
break; 

default: 

// All other zoom modes 
::SetCursor(m_hZoomCursor); 
break; 

} // Zoom mode select 

return TRUE; 

} // OnSetCursor 

// End of File 
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64-Bit Ints for Huge Files 
and Volumes 

Mike Potter 



Both Windows 95 and Windows NT can handle files larger than 2Gb, which 
is the largest number a 32-bit int can contain. This article describes the largely 
undocumented facility Visual C++ supplies for dealing with 64-bit integers and 
includes some code I use to accomplish some common tasks with them. 

The Problem 

Consider the simple DOS task of calculating how much room is left on a 
specified drive. Ignoring error checking (and future legibility), this task could be 
accomplished in as little as three lines of code. 

struct_diskfree_t dinfo; 

_dos_getdiskfree(2,&dinfo); 
long AvailableSpace = 

(long) dinfo.avail_clusters * 

(long) dinfo.sectors_per_cluster * 

(long) dinfo.bytes_per_sector; 

Windows 95 and Windows NT offer a function which handles the same task in 
somewhat the same way: 

BOOL GetDiskFreeSpace( 

LPTSTR IpszRootPathName, 

LPDWORD IpSectorsPerClustor, 

LPDWORD lpBytesPerSector, 

LPDWORD 1pFreeClusters, 

LPDWORD lpClusters); 

In porting to the 32-bit environment, I had only to modify my old code to use 
the new function: 


GetDiskFreeSpace(_TEXT("C”), 
ASectorsPerCluster, 
ABytesPerSector 
HFreeClusters, 

&C1usters); 

DWORD AvailableSpace = 
SectorsPerCluster * 
BytesPerSector * 

FreeClusters; 


Mike Potter is the Director of Information Systems for a public transit authority and has 
been programming for 10 years, with the last five strictly in Microsoft Windows. Mike 
can be reached via CompuServe at 70414,2121. 
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Listing 1 uint64.hpp — Declarations for 64-bit int 
functions 


#ifndef UINT64_HPP 

#define UINT64JPP 1 


^define UINT64 
♦define INT64 
V/defi ne L0_DW0RD(1) 

//def ine HI_DW0RD(1) 

((DWORD)(((unsigned _int64)(l) 
y/defi ne MAKE_UINT64( 1 ow. hi gh) 


unsigned _int64 

_int64 

((DWORD)(1)) 

\ 

» 32) & OxFFFFFFFF)) 
\ 


((unsigned _int64) (((DWORD)(1ow) I \ 

((unsigned _int64) ((DWORD) (high))) « 32))) 


(/define MAXJJINT64 ((UINT64)0xFFFFFFFFFFFFFFFF) 


//define UINT64_DECIMAL (DWORD) 1 
//define UINT64_HEXADECIMAL (DWORD) 2 
//define UINT64JINARY (DWORD) 4 
//define UINT64_SPACER (DWORD) 8 
//define UINT64_FULL_DEPL0Y (DWORD) 16 


BOOL Make64String(UINT64 u64Num,LPTSTR szBuffer.int nSize, 
DWORD dwFlags = UINT64_DEC1MAL|UINT64_SPACER); 


BOOL Make64String(INT64 n64Num,LPTSTR szBuffer.int nSize, 
DWORD dwFlags = UINT64_DECIMAL|UINT64_$PACER); 

//endif //UINT64_HPP 
// End of File 


I successfully compiled and distributed the new code, 
drew my paycheck, and called it a day. Later in the week, 
I learned that a user had deployed my code on a disk 
volume that exceeded 4Gb and had called to complain 
that my software was pointing out the lack of free disk 
space on a drive that actually had over 4Gb free. What I 
really needed was a 64-bit integer to deal with my over¬ 
flowing 32-bit parameters. 

64-Bit Ints in Visual C++ 

Somewhere, deep in Jeffrey Richter's book Advanced 
Windows, under the Threads chapter concerning a timing 
algorithm, I ran across a little gem that Microsoft has hid¬ 
den in its Visual C++ 2.X compiler - 64-bit integers. You 
can declare them using the nonstandard _int64 keyword: 

_int64 AnInt; 

unsigned _int64 AnUnsignedlnt 

These 64-bit integers can be OR d, ANDd, XORd, NOTd, com¬ 
pared, incremented, decremented, multiplied, divided, 
added, and subtracted just like the rest of the family. Now 
I have an integer that can represent numbers from 1 to 
18,446,744,073,709,551,615. I can already see many 
other uses for these super large integers. Without any real 
effort, I can exchange the free space calculation with the 
64-bit integer supplied and thus handle the overrun prob¬ 
lem: 


UINT64 AvailableSpace = 

(UINT64) SectorsPerCluster * 
(UINT64) BytesPerSector * 

(UINT64) Freed usters; 

For readability (and to prevent carpal 
tunnel syndrome), I use macros to re¬ 
define _fnt64 and unsigned _int64 
to INT64 and UINT64, respectively. 

ASCII Representations 

Although this new, nonstandard 
data type solves the problem of per¬ 
forming calculations involving huge 
files and volumes, it does not solve 
the problem of displaying and allow¬ 
ing users to enter 64-bit integers. De¬ 
veloping string representations of 64- 
bit numbers is not quite as easy as 
using them. After experimenting with 
different methods, I quickly came to 
the conclusion that I only wanted to 
do this once, and the result is in 
uint64.hpp (Listing 1) and uint64.cpp 
(Listing 2). 1 wanted one function that 
would be able to create binary, hexa¬ 
decimal, and decimal representations 
with some simple formatting options 
to increase readability. I also made 
the command decision to use excep- 
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tion handling to deal with any bad 
string buffer that might be passed. In¬ 
side the function I catch any bad 
pointer access exception using a 
try/except pair and return FALSE. Of 
course, in real life I also insert some 
ASSERT macros at the front of the 
function to help in debugging, 
though you won't find them in the 
listing. For future use I constructed 
the function to be UNICODE-aware. 

If you examine Make64String() in 
uint64.cpp (Listing 2), you will notice 
that it takes a UINT64, a pointer to a 
string buffer, the size of the string 
buffer, and some flags. The first three 
are self-explanatory. The fourth pa¬ 
rameter, dwFlags, defines how the AS¬ 
CII representation should be con¬ 
structed. First, you must choose the 
base on which you wish the number 
developed: 

UINT64_DECIMAL 

UINT64_HEXADECIMAL 

UINT64JINARY 

These flags are mutually exclusive 
and their names speak for them¬ 
selves. Essentially, the function takes 
the 64-bit number and divides it 
down to zero by the base while stor¬ 
ing the remainder of the operation 
into a buffer. This creates a backward 
representation of the number which 
the function quickly flips around at 
the end. 

These first three flags can be OR d 
with either, both, or none of the next 
two flags: 

UINT64_SPACER 

UINT64_FULL_DEPL0Y 

UINT64_SPACER adds a little formatting 
to help with readability, in decimal 
mode, it is represented by a comma 
every three digits; in hexadecimal, by 
a colon every four digits; and in bi¬ 
nary, by a colon every eight digits. 
(Take my word for it, numbers this 
big are much easier to read with 
UINT64_SPACER.) UINT64_FULL_DEPL0Y only 
works with the hexadecimal and bi¬ 
nary modes and is ignored in the 
decimal mode. It causes the string to 
be filled to the maximum amount of 
digits representable by the 64-bit 
number by adding zeros to the front. 


Listing 2 uint64.cpp — Definitions for 64-bit int functions 

// Exchange "stdafx.h" for "windows.h" 

spacerCount = 0, 

// if compiling for MFC in Visual C++ 

tcharCount = 0; 

finclude "windows.h" 

UINT64 temp; 

^include "UINT64.hpp- 

TCHAR printable. 


spacer; 

BOOL Make64String(UINT64 u64Nu»,LPTSTR szBuffer, 


int nSize,DWORD dwFlags) 

if (UINT64 FULL DEPLOY S dwFlags) maxOut = TRUE: 

{ 

else maxOut * FALSE; 

BOOL maxOut, 


useSpacer * FALSE: 

if (UINT64 DECIMAL i dwFlags) { 

int style, 

style = 10; 

index = 0: 

if (UINT64 SPACER & dwFlags) { 

DWORD maxCount, 

useSpacer = TRUE: 

top, 

spacer = TEXT 

bottom, 

spacerCount = 4: 



RoboHELP*, 

RoboHELP guides you through the entire process of creating Help systems and electronic hypertext docu¬ 
ments for Windows 95, Windows 3.x, and Windows NT! Point-and-click for full support of ALL Windows 
Help features, including jumps, popup windows, macros, and secondary windows. Now new Windows 95 
support for: contents tabs, secondary windows, authorable buttons, enhanced multimedia and graphics, 
all the new macros, plus SmartHelp™ OLE Control to easily add context-sensitive Help. 


WinHelp Video Kit™ 

Everything you need to quickly and easily add Video and Sound to any Windows Help system and create 
"live" video product tutorials. Includes Software Video Camera™, Video Wizard™, Video Tester, Video 
Player, and Video for Windows Runtime. 


Mastering WinHelp™ 

This video is the best way for new Help Authors to become productive immediately. 


WinHelp Tool Kit™ 

Make your job easier with these powerful tools. Includes new WinHelp 
BugHunter™, a real life-saver when trying to resolve incorrect context-sensitive 
Help calls. Also includes Help-to-Word™ Help Decompiler, WinHelp Graphics 
Locator™, WinHelp Graphics Library™ clip art collection, and 
WinHelp Inspector™. 

WinHelp Hyperviewer™ 

Enables your Help users to do what they have never been able to do before - 
print multiple topics at once, navigate using an expandable, collapsible 
book/page view, and use Full-text search for any text in the Help system, not just 
author-defined search keywords. 



WinHelp OFFICE Includes 
RoboHELP, the Ultimate 
Help Authoring Tool. 


Moving to WinHelp '95™ 

Automatically convert your Windows 3.x Help systems to Windows 95 Help systems. Automatically adds 
Windows 95 features to your Help systems and updates your source. The easy way to move to Windows 95! 



Call Today loFalnee Information Packet ~ 1 

1-800-718-4406 

^ International: 619459-6365 Fax: 619459-6366 http://www.blue-sky.com J 


a Request Reader Service #205 □ 


October 1995 


Windows Developer’s Journal — Page 49 

















e What an NT Server 
Can Really Do! 



RPC for NT 


fey Guy Eddon 

RPC for NT shows you how to write a 
distributed application using the Remote 
Procedure Call model, a powerful 
technology that allows server and clients to 
share not just data files but CPU cycles. 

Using Microsoft’s RPC implementation, an 
NT server and clients running MS-DOS, 
Windows 3.1, Windows for Workgroups, or 
Windows NT can work together to solve a 
complex problem in a fraction of the time it 
would have taken a single machine. 


Build Remote Procedure Calls 
from basic to sophisticated 

Guy Eddon guides you from a simple "Hello 
World" RPC application through a series of 
increasingly demanding programs that 
encompass all aspects of remote procedure calls. 
You’ll learn about: 

■ Implicit and explicit binding procedures 

■ Structured exception handling 

■ Multithreaded servers 

■ The RPC name service 



Range 

1 computer (sec.) 

4 computers (sec.) 

Ratio 

i -1 non 

3S 

40 

0 88 

100.000- 101.000 

40 

42 

0.95 

1.000.000- 1.001.000 

100 

61 

1.64 

10.000.000- 10.001.000 

581 

170 

3.42 









.01 


DISK 

INCLUDED 


Order your copy today! 


Use code T58C when ordering 
RPC for NT with disk included 

913-841-1631 
FAX 913-841-2624 

□ Request Reader Service #293 □ 


$ 39 - 

plus shipping 


VISA 














































Listing 2 continued 

) 

) 

top--; 

maxOut = FALSE; 

if ((style == 2)&&(useSpacer)&& 

i 

i 

(((index + 1) X spacerCount) == Dili 

i 

else if (UINT64JEXADECIMAL & dwFlags) { 

(index > D) { 

except((GetExceptionCode() == 

style = 16; 

if (nSize < (index + 2)) return FALSE; 

EXCEPTION ACCESS VIOLATION) ? 

if (UINT64_SPACER & dwFlags) { 

szBuffer[index++] = spacer; 

EXCEPTION EXECUTE HANDLER : 

useSpacer = TRUE; 

i 

EXCEPTION CONTINUE SEARCH) { 

spacer = _TEXT 

if (nSize < (index + 2)) return FALSE; 

return FALSE; 

spacerCount = 5; 

if (temp > 9) { 

) 

j 

printable -= 10; 


if (maxOut) maxCount = 16; 

szBuffer[index++] = 

return TRUE; 

i 

TEXT('A’) + printable; 

i 

else { 

i 


style = Z; 

else szBuffer[index++] = .TEXTC0’) + 

BOOL Make64String(INT64 n64Num,LPTSTR szBuffer. 

if (UINT64.SPACER & dwFlags) { 

printable: 

int nSize,DWORD dwFlags) 

useSpacer = TRUE; 

u64Num /= style; 

t 

spacer = TEXT(':'); 

tcharCount++; 

UINT64 u64Num; 

spacerCount ■ 9; 

if (maxOut) { 

LPTSTR buffer = szBuffer; 

i 

if (tcharCount == maxCount) 

if (dwFlags & UINT64 DECIMAL) { 

if (maxOut) maxCount = 64; 

maxOut = FALSE; 

if (n64Num < 0) { 

i 

i 

try ( 


i 

szBuf fer[0] = _TEXTC-'); 

try { 

while ((u64Num)||(maxOut)); 

buffer = &szBuffer[l]; 

if (style == 2) { 


i 

if (nSize < (index + 2)) return FALSE; 

if (style == 16) { 

except((GetExceptionCode() == 

szBuffer[index++] * TEXT(’b’); 

if (nSize < (index + 3)) return FALSE; 

EXCEPTION ACCESS VIOLATION) ? 

j 

szBuffer[index++] = TEXT(’x'); 

EXCEPTION EXECUTE HANDLER : 

do { 

szBuffer[index++] * TEXT!'8'); 

EXCEPTION_CONTINUE_SEARCH) { 

temp = u64Num X style; 

) 

return FALSE; 

fifdef UNICODE 


i 

printable = LOWORDUO DWORD(temp)); 

szBuffer[index] = (TCHAR) 0; 

n64Num *= -1; 

//el se 

top * index • 1; 

nSize--; 

printable = LOBYTE(LOWORD(LO_DWORD(temp))); 

bottom = 0; 

) 

tfendif // UNICODE 


i 


while (bottom < top) { 

u64Num = (UINT64)n64Num; 

if ((style != 2)&&(useSpacer)&& 

printable = szBuffer[bottom]; 

return Make64String(u64Num,buffer,nSize,dwFlags); 

(((index + 1) % spacerCount) = 8)) ( 

szBuffer[bottom] = szBuffer[top]; 

i 

if (nSize < (index + 2)) return FALSE; 

szBuffer[top] = printable: 

// End of File 

szBuffer[index++] ■ spacer; 

bottoms 



I added this functionality for debug¬ 
ging purposes and left it in for un¬ 
known future uses. You may find it 
very useful if you need to visually 
compare and verify the bits of 
UINT64s during a debugging session. 

Taking advantage of C++'s ability 
to overload function names, I've writ¬ 
ten two Make64String() functions, one 
for UINT64 and one for INT64. The 
INT64 Make64String() function just 
peels off the negative sign if one is 
present in a decimal representation 
and then calls the UINT64 
Make64String() function. Both func¬ 
tions will return FALSE if the buffer is 
too small or invalid. 

SetFilePointerO 

I thought 1 had it all - 64-bit inte¬ 
gers and a way to display them to 
humans. As usual I was wrong. I was 
missing one more set of tools to 
make 64-bit integers truly usable. 
Take a look at one of Win32's basic 
file operation functions: 

DWORD SetFi1ePointer(HANDLE hFile, 

LONG IDistanceToMove, 

PLONG 1pDistanceToMoveHigh, 

DWORD dwMoveMethod); 
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I had forgotten that files can also be really huge. The real 
problem here is that Win32 breaks up the 64-bit address 
into its 32-bit high and low parts. Can you imagine the 
problems you would incur incrementing and decrementing 
the file pointer past the old 4Gb limit while dealing with 
record sizes? I can, because I incurred them. Keeping track 
of a 64-bit address using two 32-bit parts is beyond pain¬ 
ful, and the code developed lacks that confident glow that 
we all aspire to. Ail that's really needed here is the ability 
to break up and rebuild a 64-bit integer into and out of its 
32-bit parts. Beg, borrow, and steal - I quickly examined 
the help files on LOUORD, HI WORD, and MAKELONG and did some 
rearranging to develop the following examples of macros: 

L0_DW0RD(1) 

HIJM)RD(l) 

MAKE_UINT64(1ow.high) 

These are wonderfully self-explanatory and very easy to 
use. With little effort I was able to create a more palatable 
interface to SetFilePointerO: 

UINT64 SetFi1ePointer( 

HANDLE hFile, 

INT64 n64DistanceToMove, 

DWORD dwMoveMethod); 


and 

UINT64 SetFilePointert 
HANDLE hFile, 

UINT64 u64NewPosition); 

An error would return OxFFFFFFFFFFFFFFFF, also known as 
MAX_UINT64. Once again, all of my file positioning is integer- 
based, and I now have that priceless confidence in this 
part of my code. 

Summary 

I have exposed you to a hidden Visual C++ 2.x feature, 
64-bit integers. I have given you the necessary macros to 
disassemble and reassemble the integers into and from 
their component 32-bit parts and a function to build a 
string representation. Why so powerful a tool is lacking 
documentation, I will not hazard a guess. What I do know 
is that, given time, users will purchase the hardware that 
will make this code a necessity. Whip me, beat me, make 
me write bad checks - just don't call me on Sunday to tell 
me my code has broken. □ 
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Understanding NT 



Processor Portability 

Paula Tomlinson 


Does your software run under Windows 3.1? That's a yes 
or no question. Does your software run under Windows 
95? That's a yes or no question, too. Does your software 
run under Windows NT? That's not a yes or no question, 
because the more precise question is 'Which Windows NT 
platforms does your software run under?' The fact that 
Windows NT runs on Intel machines, MIPS machines, Al¬ 
phas, and the PowerPC raises compatibility issues for pro¬ 
grammers writing for NT, Windows 95, Windows 3.x, and 
even DOS! 

A Portable Operating System 

Unlike Windows 3.x and Windows 95, which only run 
on single-processor Intel x86 systems, Microsoft designed 
NT from the ground up as a portable operating system. 
The first shipping version of Windows NT (Version 3.1) in¬ 
cluded support for three distinct processor architectures: 
the Intel x86 family (80386 and above), the MIPS R4000 
family (R4000 and R4400), and the DEC Alpha AXP family. 
The latest version of NT, version 3.51 (released in June) 
added support for the PowerPC processor. The Windows 
NT 3.51 Hardware Compatibility List (HCL) lists 24 different 
models of uniprocessor MIPS-based systems and 9 differ¬ 
ent multiprocessor models from manufacturers such as 
ACER, DESKStation, NEC, NeTpower, Olivetti, and Siemens. 

There are 17 models of uniprocessor systems based on 
the Alpha AXP processor and five multiprocessor systems. 
Most of the Alpha systems are manufactured by DEC, but 
DEC has licensed this chip to at least one other vendor. 
The HCL lists 14 PowerPC-based systems (all uniprocessor). 
Over half of the supported PowerPC systems are based on 


Motorola's PowerStack family, as well as the long-awaited 
PowerPC system from IBM. These systems aren't cheap, 
but for the really high-end market (such as engineering 
and developer systems), the raw speed of a four-processor 
275 MHz Alpha system is hard to beat. 

What are the odds that your existing application will 
port easily, or even run as-is, under NT on one of these 
non-Intel platforms? That depends on your application, 
and you might be surprised to find that porting to the 
Win32 API can actually decrease the portability of your 
existing 16-bit application! I will discuss non-Intel portabil¬ 
ity as it relates to existing 16-bit Windows and DOS appli¬ 
cations, then I will look at how you can avoid Intel-isms in 
your 32-bit Windows 95 and Windows NT programs. With 
a little foresight, you can make porting your 32-bit Win¬ 
dows program to non-Intel platforms a breeze. 

Executing 16-bit Apps on Non-Intel 
Machines 

The typical 16-bit DOS .exe can execute successfully on, 
for example, a DEC Alpha running Windows NT. The Al¬ 
pha hardware has no particular built-in ability to execute 
80x86 instructions, but NT does. The non-Intel versions of 
Windows NT contain software to emulate 80286 instruc¬ 
tions. That's not always as dead slow as it sounds, be¬ 
cause the emulator is capable of translating oft-executed 
bits of code to the native machine language on the fly. 
This same emulator allows NT to run existing 16-bit Win¬ 
dows programs on non-Intel platforms as well. Thus, with 
a bit of luck, your existing 16-bit executable may already 
run on all the NT platforms without your lifting a finger. 


Paula Tomlinson has been developing DOS, Windows, and Windows-NT based applications and device drivers for eight years. The 
opinions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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Not all 16-bit applications - DOS applications that rely 
on very obscure internal DOS structures or Windows 3.x 
applications that rely on VxDS, for example - run on NT. 
But these applications will not run under NT on an Intel 
system any more easily than on a MIPS system. The fact 
that your 16-bit application does run on an Intel system is 
no guarantee that it will run on the alternate processors. 

The primary reason that some 16-bit applications don't 
run on non-Intel processors is simply that they use 386- 
level (or above) machine instructions. Since Windows NT 
only emulates 286 level instructions, a 16-bit binary that 
contains 386-level or above instructions will generate un¬ 
supported instruction exceptions when run on non-Intel 
platforms. You don't have to stop writing assembly level 
code or using in-line assembly in your programs, you just 
need to avoid using any instruction not included in the 
286 instruction set. For C/C++ code, this means avoiding 
using the compiler flag ('-G3' for Microsoft, '-3' for Bor¬ 
land) that generates 386-level instructions on your behalf. 
If hand-tuned 386-level assembly is necessary in your ap¬ 
plication for performance reasons, then at least consider 
isolating this code in a module that can be replaced by 
another 286-level module. 

For some applications, simply sticking with a 16-bit .exe 
may be the cheapest way to run on all the platforms NT 
supports. The best part is that you do not have to create 
and distribute a different .exe for each CPU type that Win¬ 
dows NT supports. 


Executing Win32 Apps on Non-Intel 
Platforms 

The Windows 95 API and the Windows NT API are 
largely, but not completely, identical; with a little care you 
can write software that works with both systems. Ideally, 
after you port your 16-bit Windows application to Win¬ 
dows 95, the same .exe will run unchanged under Win¬ 
dows NT on Intel platforms. Flowever, that .exe will cer¬ 
tainly not run on any non-Intel platforms - you will have 
to recompile your 32-bit executable for whatever non-Intel 
platforms you want to support. NT's emulation is designed 
only to handle 16-bit legacy applications (and only those 
that limit themselves to 80286 instructions). 

Moving to the Win32 API, then, is not a guarantee that 
your application will run on all Win32 platforms. In fact, if 
you don't recompile your application for each processor, 
then it is a guarantee that it will not! Assuming that you 
are ready to start recompiling your Win32 applications for 
the MIPS, Alpha, and PowerPC, here are a few tips that 
will save you a lot of time in testing and debugging. 

Assembly Language 

If you want to be able to simply recompile your source 
code for each hardware platform, inline assembly is out. 
The compiler for an Alpha will have no idea what inline 
80x86 instructions are, for example. If you really need an 
assembly language routine, be prepared to rewrite it for 
each processor and conditionally compile the appropriate 
routine. 
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Memory Page Size 

Assuming that a page of memory 
is 4Kb in length is a mistake I often 
see made, even in published sample 
code. It just so happens that on Intel 
platforms the processor uses a page 
size of 4096 bytes. But on the Alpha, 
for example, the page size is 8Kb. A 
much more portable solution is to 
use the Win32 function GetSys- 
temlnfoO, which returns a SYSTEM_INFO 
structure that includes the dwPageSize 
field. The SYSTEMJNFO structure has 
other useful information, such as the 
processor type and number of proc¬ 
essors. Be aware that GetSystemlnfoO 
is supported on Windows NT and 
Windows 95, but not on Win32s. 

Data Alignment 

When the RISC processors running 
Windows NT encounter data that is 
not aligned on 32-bit boundaries, a 
data misalignment exception is gen¬ 
erated. On all Alpha versions of Win¬ 
dows NT (3.1, 3.5, and 3.51), the op¬ 
erating system automatically handles 
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this exception. On the MIPS and PowerPC processors, the 
data misalignment causes an exception that is not auto¬ 
matically handled by default. Because there are some sce¬ 
narios where misalignment exceptions are not handled 
automatically, you should address this problem in your 
code. 

The best solution, in terms of robustness and perform¬ 
ance, is to just avoid unaligned data all together. Even if 
the operating system is providing an exception handler to 
take care of this problem at runtime, it can still cause an 
incredible amount of overhead, and help ensure that your 
application runs slowly on some of the fastest processors 
in the world. For maximum performance on all processors, 
do not pack data structures. 

Align data structure members 
on natural boundaries for the 
given data type (i.e., if it's a 
four-byte data type, make 
sure it's aligned on a four-byte 
boundary). Use 32-bit vari¬ 
ables (such as I NT and DMORDi 
rather than 8- or 16-bit vari¬ 
ables (such as BYTE, short, 
and char) whenever possible. 

Most compilers have op¬ 
tions that control the align¬ 
ment and packing of the data 
they generate so it's relatively 
simple to make sure your 
data is aligned. For example, 

Visual C++ uses a default 
data structure packing of 8 
bytes. You may run into prob¬ 
lems though, if you've hard¬ 
coded the sizes of data types 
or data structures, or if you've 
hardcoded offsets into data 
structures. Also, be aware that 
data saved in files or coming 
across a network may have to 
be massaged before you ac¬ 
cess it. If you're concerned 
about switching completely to 
aligned data because of the 
increased overall data size, 
keep in mind that the size 
you saved by packing data on 
Intel platforms is more than 
made up for by the extra 
code it takes to handle the 
alignment problems on other 
platforms. 

If you want to make data 
misalignment exceptions visible 
on the Alpha (presumably so 
you can them), you can turn off 
the automatic handling of these 
exceptions by setting the En- 
ableAlignmentFaultExceptions 


value under the HKEY_LOCAL_MACHINE\System\Cur- 
rentControlSet\Control\SessionManager registry key. A 
value of 0x1 requests that the system allow the excep¬ 
tions to occur, while a value of 0x0 (the default) specifies 
that the system automatically fixup any data misalignment 
exceptions. This registry setting is documented under the 
SDK documentation for SetErrorMode. You can also use 
the Performance Monitor tool from the Administrative 
Tools program group. From the 'Add To Chart' dialog box, 
select the 'System' Object and the 'Alignment Fixups/Sec' 
Counter. This will give you a running count of the number 
of alignment exceptions the system is automotically han¬ 
dling for you per second. As an example, scrolling a large 
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document in the PowerPC version of 
one of the leading Word Processor 
applications generated about 1500 
alignment fixups per second. Any¬ 
thing over a few hundred exceptions 
per second is considered excessive so 
clearly the performance of this com¬ 
mercial application is suffering due to 
misaligned data fixups. 

Finally, if you know that your ap¬ 
plication access misaligned data and 
you don't plan to fix it, then you 
should at least call 

SetErrorMode (SEM_N0A LIGNMENTFA ULTEXCEPT) 
early in your code. This causes the 
operating system to automatically 
handle data misalignment exceptions 
on all processors. It also overrides 
the registry setting on the Alphas. Al¬ 
ternatively, if you know that your 
code only needs to maintain a few 
crucial pointers to unaligned data, 
you can use 4- or 8-byte packing as 
the default alignment for your pro¬ 
gram, and specify the UNALIGNED 
pointer qualifier to override the align¬ 
ment for specific pointers. The UN¬ 
ALIGNED qualifier is supported on all 
NT platforms. It instructs the compiler 
to generate the necessary code to 
handle the unaligned data, which is 
typically much more efficient than 
handling an exception at runtime. 

// pointer to unaiigned int 
UNALIGNED int *p; 

// ptr to unaligned struct 
typedef struct _XYZ UNALIGNED *PXYZ; 

Thread Context Routines 

The Win32 functions GetThreadCon- 
textO and SetThreadContextO return a 
pointer to a CONTEXT structure. This 
CONTEXT structure contains fields that 
correspond to the register set of a 
specific processor and are thus ex¬ 
tremely processor dependent. Don't 
hardcode access to specific fields of 
this structure if you can help it. If you 
must access this structure, then en¬ 
close the code in the appropriate 
processor-specific definitions {_ X86_, 
_ALPHA_MIPS_, _PPCJ and include a 
case for each processor. 

#if defined(_X86J 

Status = pContext->Eax; 

#elif defined(_MIPSJ 


#endif 

Problems That Aren't 

There are several issues that 
might appear to be processor incom¬ 
patibility nightmares, but aren't. Take 
the BIOS functions, for example - a 
set of functions designed solely for 
the PC architecture, not for a modern 
RISC machine. In order to exercise 
greater control over the hardware 
and to protect against processor and 
bus differences, Windows NT gener¬ 
ally avoids making direct calls to 
BIOS functions. In fact, it does this for 
the Intel processor as well as the Al¬ 
pha, MIPS and PowerPC. So, when 
applications call BIOS functions, these 
almost always end up being simu¬ 
lated by NT rather than executing 
any actual BIOS code. For this reason, 
it's -still a good idea to avoid the 
more obscure BIOS functions if you 
want the application to run on Win¬ 
dows NT. But if it does run on an 
80x86 processor, then it most likely 
will run on the other processors as 
well. 

You might also think that you 
would have to rewrite any NT device 
driver for each CPU architecture you 
want to support. In reality, though, 
NT device drivers can be highly port¬ 
able, despite their need to imitate ac¬ 
cess hardware. The Windows NT de¬ 
vice driver model does a very good 
job of abstracting hardware resources 
that might be processor or bus spe¬ 
cific, such as I/O ports or interrupts. If 
you follow all the rules when you 
write a device driver for Windows 
NT, then you can generally recompile 
the driver source code for the other 
processors without having to worry 
about the hardware differences. Be¬ 
cause NT kernel-mode device drivers 
are not supported on Windows 95 
and Windows 95 VxDS are not sup¬ 
ported on Windows NT, there is a 
general incompatibility between Win¬ 
dows 95 and Windows NT drivers. 
But this is an operating system in¬ 
compatibility, not a processor incom¬ 
patibility. 

You also don't need to worry 
about any issues of big endian ver¬ 
sus little endian byte order in your 
applications. Currently, Windows NT 
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only supports processors that are ca¬ 
pable of operating in little endian 
mode. 

A Portable Development 
Environment 

If you want to make your Win32 
application run under non-Intel NT 
platforms, you face some relatively 
nontechnical hurdles as well. As an 
experiment, even though I already 
knew the answer, I called the pre¬ 
sales information telephone numbers 
for Borland, Microsoft, Symantec, and 
Watcom to ask if they had compilers 
that could produce Win32 binaries 
for non-Intel platforms running Win¬ 
dows NT. Only the Watcom rep was 
able to answer this question; the 
other sales people hadn't a clue what 
I was talking about. After being for¬ 
warded to technical support, I con¬ 
firmed the fact that currently neither 
Borland, Symantec, nor Watcom is 
shipping any such compiler. Microsoft 
is currently shipping versions of Vis¬ 
ual C++ 2.0 for x86, Alpha and MIPS 
but not yet for the PowerPC. DEC has 
development tools for the Alpha as 
does Motorola for the PowerPC. 
There may be other tools available 
as well, but certainly not the selec¬ 
tion that is available for the x86. I'm 
also not aware of any tools that al¬ 
low cross-processor development, so 
if you want to build MIPS binaries, 
for instance, then you need to build 
them on a MIPS machine. You'll need 
to have access to each of these proc¬ 
essors anyway, though, in order to 
test your software on each. 

To make the development process 
as smooth as possible, you might 
consider following the example of 
the BUILD tool that ships with the 
Windows NT DDK. With BUILD, you 
specify the processor type of the tar¬ 
get binaries you want to build by 
specifying the CPU environment vari¬ 
able. The valid settings are 1386, 
MIPS, ALPHA, or PPC. The target bi¬ 
naries (.obj, .exe, .dll, etc.) are then 
placed in directories (immediately be¬ 
low the source directory) of the form 
obj\<cpu>. This kind of development 
environment allows you to easily 
keep track of one set of sources and 
several sets of binaries. It is also con¬ 
venient for keeping all the sources 
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and binaries on a single shared net¬ 
work volume. Then you can simply 
connect to that share from a Pow¬ 
erPC machine, for example, and build 
PowerPC binaries. 

Summary 

If you want to maximize the 
chances of your application's being 
supported on any proccessor running 
a 32-bit Windows operating system, 
then it's important to consider binary 
and source level compatibility issues. 
If you have a 16-bit application, try 
to avoid using the 386 instruction 
set. If you have a Win32 application, 
try to avoid processor-specific code 
and align your data on 32-bit 
boundaries. 

For Win32 developers, there's 
definitely more development effort 
and expense involved in purchasing 
these systems, then recompiling, test¬ 
ing, and supporting four different ver¬ 
sions of your program. The payback 
is significantly higher, though, as na¬ 
tive Win32 versions will run much 
faster than emulated 16-bit applica¬ 
tions. Some products, such as Mi- 
croEdge's Visual SlickEdit source code 
editor, have established a faithful fol¬ 
lowing by being one of the first prod¬ 
ucts out the door to support all four 
processors. 

Finally, DEC (and perhaps others) 
offers a porting lab service where 
software developers can arrange to 
spend time on Alpha systems at one 
of four sites (Marlboro, MA; Palo Alto, 
CA; Munich, Germany; and Basing¬ 
stoke, UK). You can get more infor¬ 
mation about DEC'S developer's pro¬ 
gram on the DEC Web page at 
http://mw. digi ta 1. com/www-swdev/. 

References 

MSDN Technical Article by Digital 
Equipment Corporation. "Porting 
Applications from Windows 
NT/X86 to Windows NT/Alpha 
AXP." MSDN April 1995. 

Custer, Helen. Inside Windows NT. Red¬ 
mond, WA: Microsoft Press, 1993. □ 


WHETHER YOU'RE 

headed to Chicago, 
Daytona, or 

POINTS UNKNOWN, 

BasicScript helps 


Daytona 



YOU 

ARRIVE 

IN 

STYLE. 


po* ef 

ujj-- Summit 
BasicScript 


0 S/ Z 


Toolkit 

makes 


it easy and economical to add an 
award-winning scripting language 
to your application. 


B Easy-to-use APIs make it simple to 
integrate BasicScript into your 
application using C, C++, Visual 
Basic, or other tools. 

B Compatible with the syntax of 
Microsoft Visual Basic and Visual 
Basic for Applications (VBA). 

B Controls OLE Automation objects in 
Windows, Windows NT, Windows 95, 
and Macintosh applications. 

B Extensibility p —--j 

architecture | Call today for i 
allows you I yOUR FREE ! 

yoTown I evaluation COPY,! 

keywords to 1 315 445.9000 

BasicScript. ‘-—-J 

B Available for Windows 3.1, Windows 
95 (“Chicago"), Windows NT 3.5 
(“Daytona”), MS-DOS. SunOS, Solaris 
2.x, HP-UX, IRIX, AIX, SCO UNIX, 

Ultrix, Digital UNIX, UnixWare, 
Macintosh, Power Macintosh, 

NetWare, OS/2, and OpenVMS. 

B Runtime can be redistributed by your 
customer without royalties, 
a Free technical support, 
comprehensive documentation, and 
numerous code samples keep your 
engineering costs to a minimum, 
a Licensed by Symantec, Delrina, Intel, 
and other leading companies. Named 
PC Magazine Editors’ Choice among 
cross-application macro languages, 
a Flexible licensing terms mean you can 
afford the finest scripting language on 
the market today. 


<$> B/ssicScript 


Summit Software Company 

Fax: 315 445.9567 
CompuServe: 71211.3504 
Internet: info@summsoft.com 
WWW: http://www.summsoft.com 


□ Request Reader Service #302 □ 
Windows Developer’s Journal — Page 57 








1 

I ’ 

| 

l/Vindows 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

PROGRAMMING BOOKS 


Hard-to-find titles and titles you won’t find anywhere else 

Windows ■ DOS ■ PC Hardware ■ Visual Basic ■ C++ 



Karen Hazzah f ~g~( 

Writing "O 
Windows VxDs 

and Device Drivers 

-- ‘.JSYSVMfc 


Complete Source Code Included 


Writing Windows VxDS and Device 
Drivers 

By Karen Hazzah 

Karen Hazzah explains the full range of 
alternatives for interfacing Windows 
applications to hardware, from the 
simplest DLL (Dynamic Link Library) or 
TSR to complex VxDs (Virtual Device 
Drivers). Karen shows how to write a 
VxD without burying the reader in 
Windows trivia and API references. This 
book is not for the beginner. These 
techniques require knowing assembly 
language, C, and DOS, especially direct 
calls to DOS using interrupt INT21. 

R&D Publications, 1995, 350 pp. 

ISBN 0-13-100181-7 

T59C with disk.$49.95 


WILLIAM SMITH 
ROBERT WARD 







1 



hi 


WINDOWS 

CUSTOM 

CONTROLS 


Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
modular technique that brings structure 
and reusability to Windows application 
designs. Reusing the custom controls 
allows you to focus on the larger design 
issues. 

R&D Publications, 1993, 531 pp. 

ISBN 0-13-034497-4 

W99S with disk.$55 



MS-DOS' 


system programming 

29 Pearls for DOS Programmers 


edited by 

David Burki 
Robert Ward 



MS-DOS System Programming: 

Third edition 

Edited by David Burki & Robert Ward 

Veterans and beginners will all find 
something in this collection to save time 
and program MS-DOS more efficiently. 
Some of the updated chapters include 
critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, TSRs, 
accessing the global environment, and 
interfacing to the floppy disk controller. 
New chapters include serial 
communications, the floating point 
coprocessor, CD-ROM drivers, Direct 
Memory Access, and the PC speaker. 
Each chapter gives complete details and 
can be read independently. The 
companion disk includes all the code. 

R&D Publications, 1994, 811 pp. 

ISBN 0-13-207382-X 



Building 

Rtmot* Procedure Celle 
for Window* NT Networks 


RPC for NT 

By Guy Eddon 

RPC for NT shows how to harness the 
power of distributed computing on a PC 
network with a Windows NT server. Guy 
Eddon provides a step-by-step guide to 
developing Remote Procedure Calls. He 
explains standards and requirements, 
how RPC is related to other parts of 
Windows, and how to use RPC with 
parallel processors, multiprocessors, and 
transputers. Use RPC to solve problems 
in a fraction of the time it would take a 
single machine. 

R&D Publications, 1994, 427 pp. 

ISBN 0-13-100223-6 

T58C with disk.$39.95 


V36 with disk 


.$39.95 


You may FAX your order to 913-841-2624 or 
e-mail it to rdorders@rdpub.com 

All orders must be prepaid in US dollars by check, money order, 
or credit card—MasterCard, and VISA are accepted. 


FREE 1995 R&D Technical Book Catalog 

R&D publishes advanced programming books, as well as 
C/C++ Users Journal and Windows Developer’s Journal. 
Get your complete catalog of R&D programming books, 
along with descriptions of more than 150 useful books 
from a dozen different publishers. 

CALL TODAY — 913 - 841 - 1631 . 

Or, use the Reader Service card in this magazine. 

□ Request Reader Service #177 □ 































































■ Tech Tips 


59 



Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they 
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An RTF Token Conversion Utility 
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Word 6.0 and version 3.10.505 of the WinHelp compiler are incompatible 
when it comes to the special-character RTF tokens that Microsoft Word 6.0 
generates, such as the bullet character and special quote characters. For in¬ 
stance, Word 6.0 generates a Ibuilet token for a bullet symbol in a normal 
font, but the help compiler only understands the I ’95 notation. 

To fix this problem, I wrote fixrtf.c (Listing 1), an MS-DOS program, to 
make the following translations in an RTF file: 

\lquote to \’91 
\rquote to \’92 
\1dblquote to \’93 
\rdb1quote to \'94 
\bullet to \’95 
\endash to \’96 
\emdash to \’97 

To use fixrtf, compile it, then specify the name of the RTF file on the com¬ 
mand line. The orignal file is renamed to a .BAK extension, and the translated 
file uses the original filename. 
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Listing 1 fixrtf.c — Code to fix RTF output of WinWord 6.0 


/* 

fixrtf.c Robert Mashlan (rmashlan@r2m.com) 

This file compiles to a DOS program. The program Is 
used to translate the special character RTF tokens that 
Microsoft Word 6.8 generates, but the help compiler does 
not understand. 

fixrtf makes the following translations: 

\lquote to V91 
\rquote to V92 
Udblquote to V93 
\rdblquote to V94 
\bullet to V95 
\endash to V96 
\emdash to V97 

Borland C++ v4.5: 

bcc -c -ms -vl fixrtf.c 
tlink /A=16 /c 1C /l /s /Tde \ 

c0s .obj+f l'xrtf. ob i . fixrtf. execs. 1 i b 
Visual C++ vl.5: 

cl /c /W3 /If /Gs /AS fixrtf.c 
link /nologo /NOE /MAP:FULL /LINE \ 
fixrtf.obj,fixrtf.exe,fixrtf,,; 


/(Include <stdio.h> 

/(include (string.h> 

/(include <stdlib.h> 

/(include <ctype.h> 

int convert! const char *infn, const char *outfn ) 

{ 

FILE *fi, *fo; 

Int state = 0: 
char token[80]: 

Int tokenl: 
int nesting; 
unsigned Int bin; 

fi = fopen(infn,"rb"): 

If(lfi) { 

printfC'unable to open %s for reading\n",1nfn); 
return errno; 

} 

fo = fopen(outfn,"wb"); 

1f( !fo) { 
fclose(fl); 

printfC'unable to open %s for writing\n",outfn); 
return ermo; 

) 

whiled) { 
int again = 0; 
int inchar = getc(fi); 
if( inchar == EOF ) 
break; 

do { 

again = 0; 
switch(state) { 
case 0: 

if(inchar == '(’) 
nesting++; 
ifdnchar ~ ')') 
nesting--; 

ifdnchar == '\V ) { 
state++; 
tokeni = 0; 

) else 

putcdnchar.fo); 

break; 

case 1: 

switch(inchar) { 

// control symbol without parameters 

case : 

case : 

case 'W : 

case '{' : 


case : 

case T : 
putcCW'.fo): 
putcdnchar.fo); 
state--; 
break: 

default: 
tokeni = 0; 

token[tokeni++] = '\V; 
token[tokeni++] = Inchar; 
state++: 
break; 

) 

break; 
case 2: 

if(isalnim(inchar)l|inchar='-') ( 

token[tokeni++] = inchar; 

) else { 

token[tokeni] = 0; 

if( strncmp(token,"\\bin",4) = 0 ) { 
bin = atoi(token+4); 
state = 3; 
fputs(token.fo); 
break; 

} 

if( strcmpltoken."Wrquote”)==0 ) { 
fputs(”\V92",fo): 
state = 0; 
break; 

} 

if( strcmp(token,”\\lquote")==0 ) { 
fputs("\\'91",fo); 
state = 0; 
break; 

) 

if( strcmp(token,"\\ldblquote")=0 ) { 
fputs("\V93",fo); 
state = 0; 
break; 

} 

if( strcmp(token,"\\rdblquote")==0 ) { 
fputs("\V94",fo); 
state = 0; 
break; 

) 

iff strap!token."Wbul 1 et")==0 ) { 
fputs("\V95",fo); 
state = 0; 
break; 

} 

if( strcmp!token,"\\endash")==0 ) ( 
fputs("\V96",fo); 
state = 0; 
break; 

) 

1f( strcmp(token,"\\emdash")==0 ) ( 
fputs("\\'97",fo); 
state = 0; 
break; 

} 

fputs(token,fo); 

state = 0; 

again = 1; 

} 

break; 


case 3; 

// reading binary data 
putcdnchar.fo); 
bin--; 
if(lbin) 
state * 0; 
break; 

} 

) while(again); 

) 

fclose(fl); 

fclose(fo); 
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Listing 1 continued 

return 0; 

} 

printf("error renaming lSs\n",outfn); 
return errno; 

) 

r = convertlinfn,outfn); 

int main! int argc, char **argv ) 

{ 

if(r) 

If( argc > 1 ) ( 

return r; 

int i; 

) 

for(1=l;1<argc;1++) { 

1 else { 

Int r; 

printfCThis program converts an .RTF file that has " 

char infn[80]; 

"special character tokens that\n" 

char* outfn * argvfi]; 

"the help compiler doesn't understand. " 

/* form back up file name (use .bak extension) */ 

"Place .RTF file to be converted\n" 

_splitpathtoutfn.infn,NULL,NULL,NULL): 

"on the comnand line. The orignal is saved to " 

splitpath< outfn,NUL L,infn+strlen ( infn ) ,NULL,NULL); 

"have a .bak extensiontn"); 

_splitpath(outfn,NULL,NULL,infw-strlen(infn),NULL); 

) 

st rcat ( i nf n, " . ba k" ) ; 

return 0; 

unllnk(infn); /* delete old backup file */ 

i 

/* rename file to backup file */ 
if( rename(outfn.infn) ) { 

/* End of File */ 
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Greetings, 

I am a couple of months behind in my reading, and 1 
am just now getting to the March 95 Tech Tips column. 
Someone may already have made this suggestion, but I 
figured I'd send it anyway. 


The 'Automatic Timeout and Default Answer for Mes¬ 
sage Boxes' tip by Jim Butts had a small problem with the 
Watcom resource compiler. I believe I have a way to gen¬ 
eralize the dialog resource to work with all compilers. 
Following is the original dialog resource definition: 

TIMEDMSGBOXDUMMY DIALOG DISCARDABLE 0, 0, 10, 10 

STYLE DS_MODALFRAME | WS.POPUP 

CAPTION 

BEGIN 

END 


Need a Network Programming Solution 


NetWare ® 

C++ Class Libraries for NetWare Developers 
Now with IPX/SPX/SAP Classes 


* DOS/Windows Client Libraries 

* MSVC 1.5 and Borland 4.5 

* 300+ pages of Documentation 

* Source Code Included 

* 30 Day Money Back Guarantee 

"ORC++ Objects for NetWare" 


' Bindery, Queue, Print, Print 
Capture, Connection, Work¬ 
station, Dir file classes 

Um „ ed 

t $299.00 , 

price y:' Offer 



f TCP/IP 

l P Software ® SDK 

* C Interface for 
DOS / Windows 

* Sockets Interface 

* RPC & SNMP APIs 

* Winsock Compliant 

* Visual Basic Custom 
Controls built over 
Windows Sockets 

* Examples Included 



"PC/TCP OnNet 


d ,v **/!*,„ , 

fK&SSWL 

$369.00 ' 


Developers Toolkit" / ^ ^ 


Debugging? 

Arcnet, ethemet, token nng protocol- 

decoders start at:.$299.00 

SLIP/PPP Decoder:.$399.00 

Ask for live demo diskette. 


Windows NT ™ 

Network programming text 

* Covers Versions 3.1 and 3.5 

* Named Pipes, NetBIOS, 
Windows Sockets, TCP/IP, 
IPX/SPX, Remote 
Procedure Calls 

* Sample apps include 
generic peer-to-peer 
networking API 

* Diskette with source.k^ 

'Windows NT Network 3^ 

Programming" Ralph y X 

Davis ' ^ T ' 

Additional book solutions ... 

Client/Server LAN Programming $44.95 

UNIX Network Programming $55.00 

UNIX System V Network Programming $47.95 
Programming WinSock $31.95 

Teach Yourself ODBC Program g in 21 Days $27.95 
There’s more, Ask for our book listings. 



hni 

(S QS ^ 


We’ve got vou covered. 


'Network Programming Solutions' 
Systems Support Group 
1-800-422-6414 
International call (214) 422-6260 

P.0 Box 940723, Plano TX 75094 


□ Request Reader Service #207 □ 


EtherViewPro 6.0 for DOS 

$99 introductory special thru October 31,1995 


Tools for documentation and programming 
in the Windows 95’s console mode and 
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■ EtherView, multi-windowing user interface following 
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■ Print Spooler, background printing. 

■ EtherHelp, an excellent on-line help browser. 

■ EtherHC, the help file compiler. Features encryption; 
generates topic checklist, topic-tree, lists of parent-topic 
vs. topic, undefined, redundant and incomplete buttons, 
and defined-but-unused topics; and more 

■ EtherScreen, a screen saver with password support 
and variable idle. 

■ On-line help books to master EtherViewPro. 

Bundle Regularly $245. Call for student/home-use discount pricing. 
Windows 95’s console mode version coming soon! 

Also available: EtherViewSDK (Windows 95’s console 
mode and DOS text mode) exploits the power of EtherView 
via event-driven, C/C++ programming interface. 

EtherLab Software Technology 

Raffles City, RO. Box 251, Singapore 9117, Singapore 

Call or fax today (65)324-1563 
(US readers: 011-65-324-1563) 

CUA is a registered trademark of IBM Corp. Windows is a trademark of Microsoft Corp. 
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This can be changed to the following: 


Listing 2 getinst.c — Function to obtain current 
instance 


#inetude <windows.h> 

//include <toolhelp.h> 

I **★*★★*★★**★*★*★★***★*★****★★★★*★★★★**★**★★★★★★*******★★■*•** 

GetCurrentHINSTANCEO 

Title: Get the H1NSTANCE of the current process. 

Return: NULL if the HINSTANCE could not be found. 

Otherwise, handle to the current instance. 
Description: This function uses the ToolHelp functions 

GetCurrentTask and TaskFindHandle. 

These only work on Windows 3.1 or later. 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A:*** j 

HINSTANCE GetCurrentHINSTANCE 0 
{ 

TASKENTRY telnfo: 

HINSTANCE hinstCurrent = NULL; 

// Required to initialize size of structure first, 
telnfo.dwSize = sizeof (TASKENTRY); 

if (TaskFindHandle (&teInfo. GetCurrentTask ())) 

{ 

hinstCurrent = telnfo.hlnst; 

} // *if* 

return hinstCurrent; 

} // *GetCurrentHINSTANCE* 

/* End of File */ 


TIMEDMSGBOXDUMMY DIALOG DISCARDABLE 0. 0. 10. 10 

STYLE DS_MODALFRAME I WSJOPUP 

CAPTION 

BEGIN 

CONTROL "STATIC". NOT WSJ/ISIBLE, 0. 0, 10, 10 
END 

This has a single control in it, so that the Watcom re¬ 
source compiler will be satisfied - the control shouldn't 
show up. 

In the same column, Ron Burk submitted a tip on "The 
(Secret) Global Instance Handle." This is useful information, 
but there is another way of getting the current instance 
handle that is not compiler dependent, getinst.c (Listing 2) 
shows a complete routine that will get the current in¬ 
stance handle. I know this works in EXEs, and I assume 
that it will work in a DLL. 

James Gomes □ 
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Windows Developer’s Journal buys dozens of articles each year 
from readers like you. You don’t have to be a writer, but you do 
have to have a concrete topic of interest to other Windows pro¬ 
grammers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. The easiest way to propose an 
article topic is to send email about your idea to the editor, Ron 
Burk, via CompuServe at 70302,2566 or Internet at 


Call for Papers 

70302.2566@compuserve.com. Make sure you include an esti¬ 
mate of the number of lines of code involved. 

If you don’t have access to email, you can fax your proposal to: 
Managing Editor, Windows Developer’s Journal, (913) 841-2624, or 
mail it to: Managing Editor, Windows Developer’s Journal, 1601 
West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


Windows NT 

■ Proposals due 15 Sep 1995 
manuscripts due 16 Oct 1995 

Suggested topics: Top ten reasons 
Windows 95 apps are incompatible with 
Windows NT. A C++ class to encapsulate 
a many-reader, single-writer semaphore. 
Benchmarking Windows NT versus Win¬ 
dows 95. A UNIX compatibility library for 
Windows NT. 


Device Drivers 

■ Proposals due 16 Oct 1995 
manuscripts due 15 Nov 1995 

Suggested topics: A script-driven file 
hook VxD for Windows 95. Tips for mak¬ 
ing a single VxD sen/e both Windows 3.1 
and Windows 95. A configurable filter 
driver for NT file systems. How to make 
your driver support Plug-n-Play. A simple 
device driver to benchmark file system 
I/O. 


Memory Management 

■ Proposals due 15 Nov 1995 
manuscripts due 15 Dec 1995 

Suggested topics: A C++ class for one- 
writer, multi-reader shared memory data 
structures. Tips for partitioning your code 
to reduce swapping. A benchmark of mal- 
loc() for multiple C compilers. The differ¬ 
ences between Windows 95 and NT 
memory management functions, and how 
to work around them. Memory manage¬ 
ment issues for thread-safe code. 
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Bug++ of the Month 

Mark Nelson 


One feature that even experienced C++ programmers 
don't often use is the placement syntax in conjunction 
with operator new. The placement syntax lets you decouple 
the two processes of memory allocation and object con¬ 
struction. 

Until recently, the placement syntax might have been 
considered to be an obscure feature of C++ that didn't 
concern most of us. But this year, the ANSi/ISO C++ stand¬ 
ardization committee voted to include a set of new con¬ 
tainer classes in the standard C++ library. These classes 
are one of the main components of the Standard Tem¬ 
plate Library, or STL. The containers in the STL all use this 
placement syntax for object creation, giving you unprece¬ 
dented flexibility in memory usage. 

The placement syntax works with new when you are 
creating a C++ object dynamically. Normally, you might 
create an object on the heap using a line of code that 
looks like this: 

foo *a = new foo; 

The global new operator will create a new object on the 
heap, based on available space. However, if you want 
your object to reside at a specific memory location (let's 
say location p) of your own choice, you can use this syn¬ 
tax instead: 

foo *a = new(p) foo; 

This special use of new then calls a different version of the 
global new operator, which you have to define in a form 
like this: 


void* operator new( size_t, void* p ) 

{ 

return p; 

} 

When combined with your custom version of new(), the 
placement syntax ensures that your foo object will be 
placed in a location of your choosing, not that of the heap 
manager. 

So why is this a good thing? There are several good 
reasons. If you are creating and destroying scads of ob¬ 
jects of a fixed size, you can often operate much more 
efficiently by allocating large blocks of memory and par¬ 
celing them out as needed (the STL does a lot of this). You 
can also use this syntax to create objects in near memory, 
far memory, huge memory, based memory, or any other 
kind of memory that has a pointer type defined in your 
environment. 

delete Is a Problem 

There is one catch: you have be careful when deleting 
objects created using this technique. A call like this: 

delete a; 

to the delete operator will invoke the standard C++ de¬ 
stroy sequence for dynamic objects: the destructor is in¬ 
voked for the object, after which its memory is returned to 
the heap. This will cause problems, because objects cre¬ 
ated using the new placement syntax didn't come from the 
heap in the first place! 

The correct way to handle this problem is with an ex¬ 
plicit call to the destructor. The unfamiliar syntax for this 
example would look like this: 

a->~foo(); 


Mark Nelson is a programmer for Greenleaf Software in Texas at Dallas. Mark is the author of The C++ Programmer's Guide to 
the Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark 
on CompuServe at 73650,312. 
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This code executes the destructor for the object, but 
doesn't do anything with the memory it uses. Since you 
are managing the memory yourself in such cases, that is 
exactly what you want. 

A History Lesson 

The operator new placement syntax and the explicit de¬ 
structor calls are both old hat as far as the ANSII C++ 
language specification is concerned. Both are defined in 
The Annotated C++ Reference Manual, which was the base 
document for the current draft specification. This means 
they have been around in their present form for at least 
five years. But just because they have been around 
doesn't mean anyone has been using them. And with so 
many other hot features for the compiler vendors to 
worry about, these custom memory management features 
probably didn't get much testing. 

This is one of several reasons that existing compilers 
have trouble with the current distribution of the STL. The 
version distributed by Alexander Stepanov and Meng Lee 
from HP has several workarounds and caveats that let it 


work with Borland; it is not supported with Visual C++ 2.x 
at all. 

The Bugs 

bugl095.cpp (Listing 1) is a sample program that demon¬ 
strates some of the problems that explicit destructor calls 
can cause. Oddly enough, both Microsoft and Borland 
have trouble with explicit destructor calls, but offer slightly 
different instances of the problem. bugl095.cpp has a tem¬ 
plate class that uses the old-fashioned mllocO call to allo¬ 
cate room for six objects at a time. The six objects are 
created in the SixPack constructor with the placement syn¬ 
tax. Likewise, the six objects are destroyed in the SixPack 
destructor through explicit destructor calls. Both Borland 
C++ 4.5 and Visual C++ 2.0 are tripped up by this pro¬ 
gram. 

Borland has trouble when you ask it to destroy a built- 
in type: 

int *p; 
p->~int(); 


Listing 1 bug1095.cpp — STL implementation problems 


// This program illustrates one of the problems 
// STL implementors have had with Borland C++ 

// and VC++ 2.x. The STL performs its own 
// memory management, which means it allocates 
// raw memory using its own routines, then 
// creates objects in that memory using the new 
// placement syntax. When destroying objects, 

// the STL has to perform explicit calls to the 
// destructor. 

II 

II Unfortunately, Borland refuses to compile the 
// destructor call on a built-in type, seen below 
// when compiling the SixPack<int> declaration. Visual 
// C++ compiles that properly, but fails on a user 
// defined type! 

// 

// Compile from the command line: 

II 

// bcc bugl095.cpp 

// bcc -DSKIPJNT bugl095.cpp //Workaround 
// cl bugl095.cpp 

// cl /DSKIP_F00 bugl095.cpp //Workaround 
II 

i/include <$tdlib.h> 
i/include <iostream.h> 

tempiatekclass T> 
class SixPack { 
protected : 

T *t; 
public : 

SixPackO; 

-SixPackO: 

}; 

void* operator new( size_t, void* p ) { return p; } 

tempiatekclass T> 

SixPack<T>::SixPack() 

{ 

t = (T*) malloci 6 * sizeof( T ) ): 


if ( t ) { 

for ( int i = 0 : i < 6 ; i++ ) 
new( t + i ) T( i ): 

} 

} 

tempiatekclass T> 

SixPack<T>::~SixPack() 

{ 

if ( t ) { 

for ( int i = 0 ; i < 6 ; i++ ) 

( t + i )->~T (); 
free( t ): 

} 

} 

struct foo { 

int a; 

foot int i ){ cout « "foot" « ( a = i ) « ")\n”; ) 
—foot){ cout « "~foo(" « a « "An"; } 

}; 

mainO 

{ 

// 

// Borland’s downfall 
II 

#ifndef SK1PJNT 
SixPack<int> a; 

#endif 

II 

// Microsoft's nemesis 
II 

#ifndef SKIPJOO 
SixPack<foo> b; 

#endif 

return 1; 

} 

// End of File 
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wsprintf (3.0) 


9 i nt _cd e cl ws p ri ntf (IpszOutput IpszFormat ...) 

r address of string for output */ 
7* address of format-control string *j 


LPSTR /pszOutput 
LPSTR IpszFormat 


Annotate 


Annotation: 


The documentation says the second 
parameter is an LPSTR, but it is actually 
an LPCSTR (and so declared in 
windows, h), so it's safe to use a string 
constant. 

Submitted by: V. Ramachandran. 


Save 


Cancel 


Delete | 
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You can understand the compiler's 
reluctance to deal with this odd-look- 
ing code, but it is in fact legal C++. 

Microsoft's Visual C++ compiler 
has no problem with destroying built- 
in types such as integers, but chokes 
instead on user-defined types. 

Vendor Review 

Borland took this bug report in 
stride. Brian Myers of Borland had 
this to say: 

Yes, we have to agree it's a bug. 

I'm happy to report, though, that 
it's already fixed in the code base 
for our next release. 

John Browne from Microsoft had 
a response that was perhaps a little 
tangential: 

We don't support STL in VC++ 

2.x, so this was never tested, nor 
was support ever implied. This is, 
however, fixed for the next major 
release. 

You might want to hang on to 
this piece of code and check it out 
with the next major releases of your 
compiler. If they can get this code 
working, there's a good chance the 
rest of the STL is working as well. □ 
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Industrial-strength ... a superb choice for full-text searching. . . 
a multitude of high-end features," - PC Magazine , 3/14/95 

NEW! dtSearch 4.0 for Win 95. NEW! dtSearch 4.0 for Win 3.1 

Searches: natural language ■ fuzzy aphonic 

■ Boolean ■ proximity ■ stemming ■ field 

■ numeric range 

With: ■ graphics viewer ■ hypertext-linked "hit" 
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Books in Brief 

First Impressions of Recent Titles 



The Computer Contradictionary 2nd Ed. 

Stan Kelly-Bootle 
253 pages 
$14.95 

The MIT Press, 1995 
ISBN 0-262-61112-0 


Once every few years, I bump into Stan Kelly-Bootle 
online or at conferences. He used to read the winning en¬ 
tries of the bad C pun contest sponsored by The C Users 
Journal at Software Development, and he always drew a 
crowd, first of people wanting to hear Stan's derivative 
(and second and third derivative) puns on the puns, and 
then of more people who just wandered over to find out 
what everyone was laughing at. In a profession crowded 
with pseudo-intellectuals, Stan is a true intellectual, by 
which I mean that he is certifiably cracked (no sane pro¬ 
grammer would price a book at only $14.95) and spends 
his time writing the stuff this book is made of. 

This is the latest incarnation of The Devil's DP Dictionary, 
but renamed due to the presence of a couple of million 
PC programmers who don't know what 'DP' means. De¬ 
spite having been working with computers since the time 
of Babbage, Stan is somehow managing to stay current in 
the field, and can intelligently skewer the very latest prod¬ 
ucts and developments in computer programming. With 
his mind-numbing grasp of English, literature, computer 
history, and programmer culture, Stan is the Umberto Eco 
of programming. While you may find much to laugh at 
here, I guarantee you won't get all the bits of humor 
packed into every corner. 

Have you heard every Microsoft conspiracy theory 
there is? Not until you've seen Stan's on page 126, where 
he picks up on the ominously named Win32 API function 
SetMorldTransformO and follows the thread through to the 



Ron Burk 

Biblical (Acts 9:24 KJV) prophecy: "They watched [the] 
Gates day and night to kill him." In this dictionary, 
Tourette's syndrome is something found among over¬ 
worked C programmers, the definition of "sarcasm" is ex¬ 
emplified with 'He left the computer industry to join DEC," 
and, lest you think the humor here lacks focus and speci¬ 
ficity, the secondary meaning of 'new' is To bloat (an 
.EXE) by inadvertently pulling in 80K of exception-handling 
code.' Stan has his own ideas about how to solve com¬ 
mon programming controversies. Should array indices 
start at 0 or 1 ? 0.5 gets his vote. What should mallocO do 
when passed a size of 0? How about terminating your 
program with a 'too much memory available' message? 
There's something for everyone here, and to prove it, 
here's a definition tailor-made for this column: 

target audience n. (computer books) all breathing primates 
with $34.95 spare change. 


Humour the Computer 

Edited by Andrew Davison 
226 pages 
$13.95 

The MIT Press, 1995 
ISBN 0-262-54075-4 


I don't think we've received any books for review from 
MIT Press before, and now we get two books at once, 
both by English (i.e., non-American) speakers, both on 
computer humor. I'm not.sure what that means, but I'm 
chagrined to see that both are more professionally written 
than the average non-humorous programming book - 
you won't catch Kelly-Bootle saying API when he means 
API function, and this book contains 16 pages of related 
reading while the average PC book suffers deep amnesia 
when it comes to referring to other authors. 



Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the 
books that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, 
expiration date, and phone number. 
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This book is a compendium of humorous essays re¬ 
lated to computers and programmers. These are the best 
of the funny pieces you've seen in trade magazines, or 
that got emailed and re-emailed across the electronic fron¬ 
tier. Remember 'Real Programmers Don't Use Pascal,' or 
how about the gag announcement that Kernighan and 
Ritchie had admitted UNIX was an elaborate April Fools' 
prank? That's the kind of writing collected here. I think the 
best (worst?) is the 'Bastard Operator From Hell' series, 
authored by the truly deranged Simon Travaglia, describ¬ 
ing the kinds of interactions beleaguered system adminis¬ 
trators must sometimes fantasize about having with users: 

(the operator is annoyed to have his game of x-tank interrupted 
by a phone call from a pesky user with yet another annoying 
question) 

"Urn, I want to know if we have a particular software pack¬ 
age?" 

"Which package is that?" 

~Uh, B-A-S-l-Cit's called." 

'>clickety clickety d-e-l b-a-s-i-c-.-e-x-e<" 

"Urn no, we don't have that. We used to though." 

"Oh. Oh well, the other thing I wanted to know was, could 
the contents of my account be copied to tape, so I have a per¬ 
manent copy of them to save at home, in case the worst hap¬ 
pens." 

"The worst?" 

"Well, like they get deleted or something." 


print 
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labels 
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database or from an ASCII file. 
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"Deleted! Oh don't worry about that, we have backups" (I'm 
such a tease) "What was your username?" 

He gives me his lusername. (What an idiot.) 

>clickety click< 

"But you haven't got any files in your account /" / say, mock 
surprise leaping from my vocal cords. 

"Yes i have, you must be looking in the wrong place!" 

So first he spoils my x-tank game, and now he's calling me a 
liar. 

>clickety click< 

"Oh no, I made a mistake" I say. 

Did he mutter "typical" under his breath? Oh dear, oh dear. 

"I meant to say: That username doesn't exist" 

(and soon...) 

Of course, one can debate whether this kind of fiction en¬ 
courages the degenerative behavior it depicts or is merely 
a healthy outlet that helps alleviate the tendency toward 
such unhealthy acting out. In any case, at least the hu¬ 
mour is compiled into one book now, so if you like this 
sort of thing, you don't have to wait for it to trickle in, and 
if you don't, now you know which book not to buy. I've 
got the book now, so please stop emailing me this stuff! 



Graphics Gems V 

Edited by Alan W. Paeth 
458 pages 
$49.95, includes 3.5" diskette 
AP Professional, 1995 
ISBN 0-12-543455-3 


Here's the latest installment of this great series of col¬ 
lected algorithms for advanced graphics programmers. A 
wide variety of graphics programmers at different compa¬ 
nies and institutions submit their favorite graphic algo¬ 
rithms or techniques, and these are collected, selected, 
and edited into this series of books. This installment con¬ 
tains 47 papers, grouped into the following categories: Al¬ 
gebra and Arithmetic, Computational Geometry, Modeling 
and Transformation, Curves and Surfaces, Ray Tracing and 
Radiosity, Halftoning and Image Processing, and Utilities. 
Many of the submissions include C or C++ source code, 
which is included on the diskette. Most of the authors 
work in the graphics workstation environment, so there is 
nothing particularly Windows-specific here. 

If you avoid any programming that involves formulas, 
if your graphics programming consists of bitmaps and 
BitBltOs, this is not the book for you. If you are into 3D 
graphics, rendering, halftoning, dithering, and so on, this is 
a great series that helps cross-pollinate ideas among high- 
end graphics programmers. 
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Delphi Programming Explorer 

Jeff Duntemann, Jim Mischel, and 
Don Taylor 

627 pages 

$39.99, includes 3.5" disk 
Coriolis Group Books, 1995 
ISBN 1 -883577-25-X 



[Editor's note: these comments were provided by George Ty- 
lutki]. 

In the Introduction Jeff Duntemann writes that he 
wanted 'to put together a presentation of Delphi that 
would get a new user up and running in as little time as 
possible - and make it a wild good ride.' This is a state¬ 
ment of the strength and weakness of the book. It is a 
very good introductory text, but a bit disappointing. 

This 'definitive guide" consists of 'alternating chapters 
of fast-paced demonstrations . . . followed by more me¬ 
thodical explanations of Object Pascal and Delphi's awe¬ 
some toolset." There are step-by-step instructions for build¬ 
ing forms, units, and applications (but not components). 
Among the topics covered are the Object Pascal language, 
the Delphi programming environment, the Visual Compo¬ 


nent Library, Multiple Document Interface, graphics, print¬ 
ing, file handling, and creating help files. 

The disk includes a shareware version of HelpGen, a 
Windows Help authoring utility, and an evaluation copy of 
Conversion Assistant, a utility for translating Visual Basic 
applications to Delphi. The disk label has a copyright no¬ 
tice, but only three of the sample programs on it are copy¬ 
righted. Whether you can use any of the other code is 
unclear. 

The book contains lots of well-written code, but there is 
no padding with long listings (nor irrelevant appendices). 
To their credit, the authors occasionally point out weak¬ 
nesses in Delphi and its documentation, admitting they 
had trouble making something work properly. I found no 
errors of fact and few typographical errors. There are 
many clear illustrations and screen shots. Although there 
are three authors, the writing is clear and consistent. The 
book is, therefore, easy to read and understand. 

However, making make the book a "wild good ride' 
apparently requires a writing style that includes phrases 
such as 'way-cool utility,' 'grok the fullness,' and 'totally 
gonzo.' And even novices will rankle at some of the con¬ 
descending statements: "some clues for the clueless"; 
'True, that's a bit of code - almost 50 lines. But it's pretty 
straightforward if you take it a bit at a time"; and "we've 
tried to minimize the brain strain." 

There are two discussions of database programming: in 
the first, a simple flat-file program is constructed; the more 


Sentry 

Spelling-Checker 

Engine 


Multi-lingual 


jAmerican, British, French, 
German, Italian, and Spanish dictionaries 
available, including accented characters. 

EaSHSUpto 16 user dictionaries, 3 types. 

Source code runs on all 
major operating systems and processors. 

Checks over 25,000 words per minute. 

i d-.mmm Add our dialogs to your 
Windows app in minutes. 

$169/DLL 

Ask about our Thesaurus Database! 

Wi mtertree Software TJkuc. 

69 Beddington Ave. St. Nepean Ont. Canada K2J 3N4 

(615) 525-6271 • FAX: 613-625-5521 
CompuServe: 72060,5056 
wsi@fox.nstn.ns.ca • http://fox.nstn.ca/~wsi/ 


□ Request Reader Service #250 □ 


HWA 2.0 

The visual and easy way 
to create and edit Windows help files! 


Did you ever need to change a WinHelp help file 
or print more than one topic at a time? 

Now you can - with Help Writer’s Assistant, 
the stand-alone true WYSIWYG help editing tool. 


HWA is a powerful, yet very user-friendly help editing tool. You will love features like: 

• Import existing help files for editing! (decompile). Everything in the original file is preserved 

• Topic tree that helps navigate through the help files topics and see the structure at a glance 

• Visual editor with multiple fonts, colors, styles, justification, indentation, borders, 
tables, paragraph and line spacing, Pictures and some embedded windows 
are also displayed in the visual editor 

• Drag and Drop is employed throughout the product to make many tasks easier! 


i Integrated spell checker | -i— i 

and thesaurus 
> Visual Button-Bar designer 


Order HWA 
for just $199 


JlyperAc 


Format insert Window Help 




t i 

3 . HWA 


(asHippi 
■ej?) Welcome to tli 

- -yiEHEHUf 

U® Shipping tirt 
U® Prices 
P® Ferry Intorrr 
Customer C 
^Glossary 
|e® Cook “ 




Welcome to Long Haul Rail. - your kind 
of shipping comp_any!H _ 

committed [♦ 



Cook Strait 
Customer Con 
Ferry Informat 
Long Haul Ra 
For Help, pre- 


General j Entry Macrc 

Title: 


Welcome to Long Haul Rail. - your kind of shipping compan 
(x Duplicate in Non-Scrolling region [x Copy Title to Context String 
Context String: jWelcome_to_long_Haul_Rail_ 


iur_kind_ol_shipping_co : 



P.O.Box 5517, Coralville, IA 52241, USA 
TeleFax. (319) 351-8413. CompuServe 76350,333 
Internet: rhalevi@hyperact.com 
Home Page: http://www.hyperact.com 


□ Request Reader Service #138 □ 

Windows Developer’s Journal — Page 71 


October 1995 




















































complex second takes up the last eight chapters (221 
pages). It is 'a fictional story about a programming con¬ 
sultant using Delphi for the first time." The story's hero, 
Ace Breakpoint, constructs a prototype of a custom data¬ 
base application. Studying another's code is a proven 
method of learning; in this narrative we are also privy to 
the programmer's thoughts as he makes false starts, en¬ 
counters errors and delays, has insights, and overcomes 
problems. Although skeptical at first, I'm now convinced 
that a narrative case-study is a useful teaching tool. Topics 
covered in these chapters include using data-aware com¬ 
ponents, handling multiple tables of various data types (in¬ 
cluding BLOBs), printing using ReportSmith, and querying 
(although not SQL). 

The narrative contains too much sophomoric humor. 
Ace is a New-Age guy from the Pacific Northwest; his girl¬ 
friend, cat, and friends interfere with his work. Duntemann 
claims that Ace's "adventure" will 'make you laugh until 
your nose runs": I didn't need any tissues. Still, it would be 
difficult to find a better introduction to basic database pro¬ 
gramming with Delphi (they do not cover client/server da¬ 
tabase development). 

Since Delphi is new, we are all 'new users," but the 
authors often equate "new user" with complete novice. 
There are instructions about which toolbar buttons to 
press (even though there are fly-by hints), but no discus¬ 
sion of null-terminated strings (pChdr in Object Pascal). Del¬ 
phi doesn't require them, but Windows does, and it should 


One version 
supports 
Windows 3.1, 
Windows NT and 
Windows 95 
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be pointed out that a lot of behind-the-scenes converting 
is done. 

A good portion of every application is dedicated to pre¬ 
venting and handling errors, but only two pages are given 
to exceptions here. Further, there are no index entries for 
'try' or 'finally," and only two for "error". The sample file- 
viewer program from Chapter 7, which uses a memo com¬ 
ponent to display text files, raises an exception when you 
try to load a file larger than 32Kb. The default exception 
handler then displays an error-message box. This is correct 
behavior but it is not explained and it must be confusing 
to novices. 

The two example database programs incorporate data- 
aware components that use the Borland Database Engine 
(composed of several DLLs and drivers). There are no in¬ 
dex entries for "BDE," 'Borland Database Engine,' or 
'IADP,' all of which refer to the same thing. What the BDE 
is, how it works, and how to incorporate it into an applica¬ 
tion that is going to be distributed to others are not ex¬ 
plained even though the book's cover claims it gives 'step- 
by-step instructions for creating commercial-quality data¬ 
base applications." 

The cover also says, 'forget the SDK, Windows handles, 
contexts, and other arcana," and, in fact, only visual com¬ 
ponents' sizing handles are mentioned. Delphi does not 
require the explicit use of handles, but a simple example 
of using one (Canvas.Handle) in a call to SetBkModeO to set 
the background mode to transparent would at least illus¬ 
trate their importance. Using hPrevInst to prevent a second 
copy of a program from running is not explained. There 
should be at least a chapter covering why the (novice) 
reader might need to deal directly with Windows and how 
to do it. 

The book is useless as a reference text. I doubt that 
readers will ever have to look up "littlethink," 'mid- 
dlethink," 'bigthink," or 'Delphi, as a middlethink product," 
nor are they likely to use the entries "code it once, use it 
forever,' 'Wack-a-Mole paradigm of programming," or 
'Romulan cloak of invisibility"! "BCI" and "Borland Graphics 
Interface' are indexed, but the BGI is part of Turbo/Bor¬ 
land Pascal, not Delphi. The index approaches being a 
parody. 

So, who will find Delphi Programming Explorer useful? 
BASIC, C, and 'database language" programmers and true 
novices will. Borland Pascal, C++, and other programmers 
familiar with object-oriented programming, especially for 
Windows, will get up to speed quickly using Borland's 
documentation. This is a very good introductory book for 
those who are unfamiliar with object-oriented, visual, or 
database programming and who want or need to use Del¬ 
phi. 
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207 Principles of Software 
Development 

Alan M. Davis 
255 pages 
$24.95 

McGraw-Hill, 1995 
ISBN 0-07-01 5840-1 



Each page of this cute little hardback book contains 
one principle related to the practice of software develop¬ 
ment. One or two pithy paragraphs sum up the principle, 
and then the bottom of the page refers you to the refer¬ 
ence (book, paper, etc.) the principle was abstracted from. 
The principles are grouped into the following chapters: 
General Principles, Requirements Engineering Principles, 
Design Principles, Coding Principles, Testing Principles, 
Management Principles, Product Assurance Principles, and 
Evolution Principles. The table of contents lists the title of 
each principle and is a quick way to skim for topics of 
interest. 

This is one of those feel-good books, the absolute op¬ 
posite of, say, Barry Boehm's classic text on software engi¬ 
neering economics. You can leaf through these pages and 
get a small, concentrated vitamin pill of software engi¬ 
neering - it's no substitute for a healthy diet of more sub¬ 
stantial information, but it might be enough to start im¬ 
proving your rickety software development process. The 
author surprised me by avoiding the classic traps of feel¬ 
good books. He did not assume that writing a "fun' book 
meant doing no work; the book is built on solid refer¬ 
ences and the author clearly did some research and syn¬ 
thesis. The author also did not focus on providing simple 
(and therefore wrong) answers for complex problems. 
Thus, you'll find sentences like "No requirements tech¬ 
nique works for all applications," rather than a pronounce¬ 
ment of 'the' correct technique. 

There are a large number of programmers who don't 
know anything about software engineering. If you don't 
know what formal methods are, if you've never drawn a 
data-flow diagram, if your cost estimation model consists 
of asking when the software has to ship, then this book 
might not be a good choice - you just won't know the 
lingo. For anyone interested in software engineering, this 
is a fun read. 

Books Received 

Steve Krantz. Real World Client/server. Maximum Press, 
1995. 375 pages. $29.95. ISBN 0-9633214-7-1. 

The banner says: 'Learn how to successfully migrate to 
client/server from someone who's actually done it!' 

Don Asumu. The Windows C++ Laboratory. I/O Press, 1995. 
425 pages. Includes 3.5" diskettes. ISBN 1-871962-34-X. 


The subtitle is 'Using the Borland ObjectWindows Li¬ 
brary.' A collection of more than 80 'experiments' that 
help you learn how to use OWL. 

Microsoft Corporation. Programmer's Guide to Pen Services 
for Microsoft Windows 95. Microsoft Press, 1995. 523 
pages. $27.95. ISBN 1-55615-835-1. 

Overviews and reference information for the Microsoft 
Windows 95 Pen API. Remember when SDKs came 
with manuals? 

Michael C. Daconta. C++ Pointers and Dynamic Memory 
Management. Wiley/QED, 1995. 464 pages. $39.95, in¬ 
cludes 3.5" diskette. ISBN 0-471-04998-0. 

Conquer your fear of * and <5 in C++. Contributes to the 
truly weird trend toward including celebrity (within 
some small circles anyway) interviews in technical 
books. 

Peter Aitken and Scott Jarol. Visual C++ Multimedia. Coriolis 
Group Books, 1995. 512 pages. $39.99, includes CD- 
ROM. ISBN 1-883577-19-5. 

Explores hypermedia, palette and bitmap animation, 
sound, and more. 

Igor Chebotko, Peter Kalatchin, Yuri Kiselev, Kiril Malakhov, 
Yuri Petrenko, Efim Podvoisky, Mike Schmit, Sergei Shkre- 
dov, Gennady Soudlenkov, and Dan Wronski. Assembly 
Language Master Class. Wrox Press, 1995. 987 pages. 
$49.95, includes 3.5" diskette. ISBN 1-874416-34-6. 
Includes chapters on disassembly, device drivers, hard¬ 
ware interfacing, sound, low-level disk I/O, data com¬ 
pression, PC video, extended memory, protected-mode 


New VxD Toolkit Enables Rapid 
Windows Device Driver Development 
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programming, viruses, Pentium 
programming, and more. 

Mike Blaszczak. The Revolutionary 
Guide to Win32 Programming Using 
Visual C++. Wrox Press, 1995. 899 
pages. $44.95, includes CD-ROM. 
ISBN 1-874416-47-8. 

A member of the Microsoft MFC 
team takes a crack at explaining it 
to the rest of us. 

Scott Stanfield, Alan Light, Mickey 
Williams, and Ralph Arvesen. Vis¬ 
ual C++ How-To. The Waite Group, 
1995. 590 pages. $39.95, includes 
CD-ROM. ISBN 1-878739-82-4. 
Dozens of task-oriented examples 
of using Visual C++ and MFC. □ 


VERSION CONTROL 


Distributed Revision 
Tracking System 


Controlled Development Distributed Development 



Parallel Development 

DRTS is based on a powerful software develop¬ 
ment model which allows Individuals and teams to 
work in parallel. Developers concentrate on developing 
software while DRTS tracks every change. Integrating 
multiple sets of changes is efficient and easy. 


DRTS is a flexible system which 
adapts to your development 
process. As you develop, 
integrate, test, and 
release, DRTS tracks every 
change at every stage. 
Maintaining multiple 
concurrent releases is 
possible because DRTS 
allows you to easily 
propagate changes 
from one release 
the next. 


DRTS provides seamless 
integration across 
diverse computing 
environments 
including servers, 
workstations, and 
laptop computers 
running Windows. 
DOS. OS/2 and 
UNIX. Whether your 
development occurs 
on a LAN or between 
multiple sites. DRTS tracks 
changes where they 
are made 


To Order, Call: 1-602-991-8281 

Visa/MC Accepted 

DOS $300 WINDOWS $300 

OS/2 $300 UNIX $500 6325 East Monte Cristo 

Quantity Discounts Available Scottsdale, AZ 85254 



□ Request Reader Service #108 □ 
Page 74 — Windows Developer’s Journal 


Build Faster & Cleaner SQL Programs 


Optimizing SQL 

by Peter Gulutzan and Trudy Pelzer 

Optimizing SQL explains the 
basics and subtleties even 
some experts don’t know. 
Careful comparisons 
demonstrate how to improve 
SQL performance and 17 
rules-of-thumb guide efficient 
applications. 


Learn ODBC and dynamic (machine-generated) 
embedded SQL 


This book explains Microsoft’s Open Database 
Connectivity interface with a complete sample ODBC 
application. You will also learn how to embed SQL in 
C, how and when to use indexes, and coding for 
portable applications. All programs are included on 
the free diskette. 


Optimizing 

SQL 




Peter Gulutzan 
Trudy Pelzer 


Embedded SQL in C 



Book with disk 

$ 34§5 

plus shipping 


Order 
Your Copy 
Today! 


To order use code V01 for Optimizing SQL with disk. 

R*D 


913-841-1631 
FAX: 913-841-2624 
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The Boyer-Moore Fast String Search 

Victor R. Volkman 


Introduction 

The Boyer-Moore Fast String Search by Patrick Shu-pui 
KO (Hong Kong) rapidly searches a buffer of text for an 
occurrence of a specified substring. KO's Boyer-Moore im¬ 
plementation comes both as an MS-DOS library and as a 
Windows DLL with import library. The Windows DLL ver¬ 
sion, boyer.dll, can be used with any Windows develop¬ 
ment tool equipped with a DLL interface that supports re¬ 
turn values as null-terminated strings. The algorithms sup¬ 
port forward and backward searching within the buffer. 
Both case-sensitive and case-insensitive versions of each 
are also available. 

KO's Boyer-Moore includes complete source code in C. 
The source and makefiles are configured for use with Mi¬ 
crosoft C 7.0, but might be portable to other compilers. 
The MS-DOS version will compile for 
large memory model by default. 

Other memory model usages should 
be possible with little or no tweaking. 

Problem Statement 

The problem solved by Boyer- 
Moore can be stated as: 

Let "p” and "s" be strings, 
where m = length of p and 
n = length of s. 


For a pattern p, find the position i in 

search space s where 

p[0] = s[i], p[l] = s[i+1], ... p[m-1] = 

s[i+m-1]. 

For the 'average' case, Boyer-Moore 
takes n/m iterations to find p in s. 

As simplifying assumptions, KO as¬ 
serts that the string alphabet must be 


no larger than 256 characters (i.e., 8-bit) and that the total 
pattern length ('p') is less than 64Kb. The search buffer 
length ('s') is limited only by the size of the block that a 
huge pointer is allowed to point to or by available physi¬ 
cal RAM, whichever comes first. If the entire text cannot 
be loaded into RAM, your application must load it 
piecewise and perform separate searches on each piece. 

API 

The Boyer-Moore implementation requires just two 
steps. First, you must initialize the pattern to be matched 
by calling SetFindPatternO with a null-terminated string, 

eg: 

SetFindPattern(“tiger”); /* hunting for tigers */ 


Boyer-Moore Fast String Search v0.3 

Author 

Patrick Ko 

C.P.O. Box 7468 

Hong Kong 

Phone: N/A 

Fax: N/A 

FidoNet 6:700/132 

Email: Internet: pko@hk.super.net 

Registration 

$20 (U.S.) 

Evaluation 

30 days 

Source Code 

Included in distribution 

Where to get it 

From the Internet: 

garbo.uwasa.fi :/windows/programming/boyer03.zip 

From the HAL 9000 BBS; 

dial +1 313 663 4173, from 2400 to 28800 bps or 
telnet to HAL9K.COM 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a freguent contributor to 
Windows Developer's Journal since 1990. He is currently employed as Software Engineer at HCIA Inc. of Ann Arbor, Michigan. He 
can be reached at the HAL 9000 BBS (313) 663-4173, telnet to hal9k.com, or email to sysop@hal9k.com. 
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WM COMPAREITEM (3.0) 


Annotation: 


The documentation tor WM_COMPAREITEM says that the parent of 
owner-drawn listboxes with the LBS_S0RT (or CBS_S0RT) styles will 
get this message in order to determine the relative position. However. 
Windows will not send the WM_COMPAREITEM message if the 
LBS_HASSTRINGS style bit is set. even if it is an owner drawn listbox 
with the LBS_S0RT style. The same is tiue for comboboxes. 

Submitted by: V. Ramachandran. 

(SDK Annotation == free T-shirt! Send your idea to 
70302.25GG@compuserve.com. Get complete annotation file from 
locations listed in table of contents, or file sdkann.zip from Library 7 
(R&D Publications) of forum SDFORUM on CompuServe ] 
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DQCINFO (3.1) 


typedef struct { /* di */ 

int cbSize. 

LPCSTR IpszDocName. 
LPCSTR 1psz Output. 

> DQCINFO. 


The documentation fails to point out that IpszOutput is limited 
to 32 character, including the null terminating byte. If you use 
a string longer than that, the trailing characters will be ignored. 
For example, if you use a string containing the too-long path: 

c:\usr\ts\issues\pendmg\12345678\abcdefgh.out 

the actual file that gets created will be: 

c:\usr\ts\issues\pending\123456 

In other words, it cannot correctly handle paths longer than 31 
characters. 

Submitted by V Ramachandran. 

(SDK Annotation == free T-shirt! Send your idea to 
70302.2566@compuserve com. Get complete annotation file 
from locations listed in table of contents, or file sdkann.zip from 
Library 7 (R&D Publications) of forum SDFORUM on 
CompuServe.) 


m 



In this stage, Boyer-Moore sets up a 
lookup table based on your input 
pattern. Note that Boyer-Moore does 
not support regular expressions, wild¬ 
card, or other non-exact matches. 

Next, you can apply any of the 
four searching functions: FindO, Find- 
BdckwardO, FindICO, or FindBack- 
wardlCO (see Figure 1 for complete 
prototypes of all functions). The func¬ 
tions are separate implementations 
to allow maximum optimization of 
the code. In each case, you must 
pass a pointer to the search buffer, 
followed by its length. A successful 
match returns a pointer to the next 
occurrence of "p" in "s'. A failed 
match returns a NULL pointer. 

Flere's an example of repeated 
searching: assume that "txtp" is a 
buffer containing 25,000 characters 
from a text file. For this example, as¬ 
sume that you only want an accurate 
count of how many occurrences 
there are of "tiger': 

SetFindPatternt “tiger” ); 
iFoundTiger = 0; 
ltxtpjen = 25000L; 
original_txtp = txtp; 
while ((matchp = Find( txtp, 
ltxtpjen)) ! =NULL) { 

iFoundTiger++; 

txtp = matchp + strlen(“tiger”); 

ltxtpjen = 25000L - (txtp - 

original J:xtp); 

) 

printf("Found %i tigers lurking!\n", 
iFoundTiger); 

Performance 

I tested Ko's implementation of 
Boyer-Moore on a 486DX2-66MHZ 
PC using Windows 3.1. The results 
were both fast and dramatic. The al¬ 
gorithm was able to find a five-char¬ 
acter string in a 1,000,000-character 
buffer in less than two seconds. This 
test was performed using the sup¬ 
plied example C program for Win¬ 
dows (as shown in Figure 2). 

Since Ko's implementation is very 
small, you may wish to compile it 
into your application rather than link 
it as a DLL. boyer.dll is a minimalist 
implementation: it does not support 
either of the two accepted methods 
of handling multiple instance data. 
This means that if two applications 
interleave their FindO and SetPat- 
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Figure 1 Complete Boyer-Moore API 


void SetFindPattern( LPSTR IpszPattern ); 
LPSTR Find( LPSTR s, LONG slen ); 

LPSTR FindBackwardt LPSTR s, LONG slen ); 
LPSTR FindICt LPSTR s, LONG slen ); 

LPSTR FindBackwardICt LPSTR s. LONG slen ) 


ternO calls, the second application might return the pat¬ 
tern that the first application was looking for. If you want 
to add multiple instance handling, you can modify 
boyer.dll either to return a unique session handle to each 
caller or else identify the callers by 
looking back into the stack and using 
their respective code segments (CS) 
as handles. 


Boyer-Moore Algorithm Demonstration 


Action Help 


initializing search space 
begin search: 

search for word "tiger -1 in 1M space: 

Find0 pattern found at offset = 999995 
FindBackwardQ pattern found at offset = A 

k 


Figure 2 Example C program for Windows 


Documentation, Licensing, 
and Support 

The BOYER documentation con¬ 
sists of a four-page plain ASCII User 
Manual. The four primary sections in¬ 
clude Description, How to Use, Ques¬ 
tions and Answers, and References. 
Each function receives a complete 
treatment, with synopsis, parameter 
list, return values, example, and see- 
also references. In addition, the demo 
program shows how to integrate 
boyer.dll calls into a Windows C pro¬ 
gram. The documentation doesn't at¬ 
tempt to address the theory of opera¬ 
tion. Interested readers can consult 
the external references listed at the 
end of this review. 

Since this package is marketed as 
shareware, you may evaluate it for 
up to 30 days before registering. If 
you decide to use it, you must regis¬ 
ter the software with its author. Reg¬ 
istration is US$20 and provides tech¬ 
nical support by email. 

Further Reading 

If you would like more back¬ 
ground on the theory and practice of 
Boyer-Moore string searches, Patrick 
Ko recommends the following texts: 
Sedgewick, Robert. Algorithms. 2nd 
ed. Reading, MA: Addison Wesley, 
1988. p. 286. 

Menico, Costas. 'Faster String 
Searches.' Doctor Dobb's Journal. 
July 1989: p. 74. □ 




-lint 



for C/C++ 

presents Bug # 624 


al.cpp 


typedef enum { red, green, blue > Color; 


void g( Color ); 


int main() 


g( green ); 
return 0; 


a2.cpp 

#include <stdio.h> 

typedef enum { red, blue, green } Color; 

void g( Color c ) 

{ 

char *color; 

switch( c ) 

{ 

case red: color = "red"; break; 
case blue: color = "blue"; break; 
case green: color = "green"; break; 

> 

printf( "the color is %s.\n", color ); 
> 


The programmer was surprised to find that the program printed ‘blue ’ and 
not ‘green’ as expected. Can you find the problem? Call if you need a hint. 
Refer to Bug #624. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new’s matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C+ + $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
PC-lint for C is still available for only $139. 

Flexe Lint for C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS. 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


Girnpsl Boffwsif 


3 


3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 


PA add 6% sales tax. 


PC-lint and FlexeLint are trademarks of Gimpel Software 
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New Products 

Industry-Related News & Announcements 


Indigo Rose Ships Updated Setup Factory 


Indigo Rose Corporation acquired NeoPoint Technolo¬ 
gies and its Doughboy Professional Install, and has up¬ 
dated the product under the new name Setup Factor 
v3.0. Like its predecessor, Setup Factory requires no pro¬ 
gramming, using a point-and-click interface to generate 
installation disks. The developer specifies the files that 
belong to the project, modifies any customization op¬ 
tions, and then presses the 'build' button. New features 
include control over introduction and conclusion mes¬ 
sages, 256-color bitmap backgrounds, gradient back¬ 
grounds with header and footer text, built-in data 

JOEY Provides Interactive 3-D Graphics 

JOEY is a new user interface toolkit for Windows 95 
and Windows NT programmers developing applications 
with interactive 3-D graphics. The product is integrated 
with Visual C++ and MFC and provides access to OLE, 

OLE automation, and multiple graphics/rendering sys¬ 
tems (including OpenGL). The toolkit will ship with Inter¬ 


GUI-Kit Adds Online Reference 

GUI-Kit is a 32-bit cross-platform toolkit for building 
user interfaces in C and C++. It supports Win32s, Win¬ 
dows NT, with support planned for Windows 95, OS/2, 
and UNIX/Motif. Version 1.1 adds support for more com¬ 
pilers (Visual C++, Borland C++, WATCOM C++, and Sy¬ 
mantec C++), and a hypertext-based online 
programmer's reference. A free demo is available in file 
gkdemo.zip in the SDFORUM forum on CompuServe, or 
from ftp.netcom. com: /pub/vs/vscftp/gkdemo. zi p. 


compression, system configuration checking, serial num¬ 
ber verification, CRC-32 data integrity checking, full con¬ 
trol over file placement, . ini file editor, splitting of large 
files over multiple disks, and program group and icon 
creation. 

Setup Factory v3.0 costs $249.95. For more informa¬ 
tion, contact Indigo Rose Corporation, P.O. Box 2281, 
Winnipeg, MB Canada R3C 4A6, (800) 665-9668 or 
(204) 668-8180; fax (204) 661 -6904; 

BBS (204) 661-3044; Support@lndigoRose.MB.CA 


active 3D Graphics in Windows, a book being published 
by Springer-Verlag in 1995. 

The JOEY Development Environment, a more extensi¬ 
ble version of JOEY, costs $250 for a single user license. 
For more information, contact Crisis in Perspective, Inc, 
1306 NWHoyt Street, Suite 409, Portland, OR 97209, 
(503) 227-7826;fax (503) 223-4453. 


GUI-Kit vl .1 for Win32s and Windows NT costs $495 
and has a 60-day, money-back guarantee, no runtime 
fees, free support, and over 3,300 portable icons. For 
more information, contact Visual Systems, Corporation, 
2512 Crosstown Boulevard N.E., Ham Lake, MN 55304; 
(612) 434-6382;fax (612) 434-6538; 

Internet: vsystems@ix.netcom.com; 

CompuServe: 73361,3131. 


Intersystem Concepts Updates Multimedia Tool 


Everest Authoring System vl .2 is the latest version of 
a multimedia development tool for creating computer- 
based training (CBT), performance support systems, kiosk 
applications, and presentations. The product can be ex¬ 
tended with third-party VBXs, and can also call DLLs and 
routines written in Visual Basic and C++. This version fea¬ 
tures tiled/textured backgrounds, background special ef¬ 


fects, vector graphic special effects, popup menus, and 
additional disk path wildcards. 

The Everest Author Software costs $199. The Everest 
Suite (unlimited runtime distribution) costs $4395. For 
more information, contact Intersystem Concepts, Inc, 
P.O. Box 1041, Columbia, MD 21044, (410) 730-2840; 
fax (410) 730-8228. 
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ObjectPro v2.0 Supports OLE 



ObjectPro v2.0 is the new version of Trinzic Corpora¬ 
tion's object-oriented application development tool. The 
product is designed to support developing business ob¬ 
jects and building client/server applications. This version 
contains a series of customizable 'wizards' that automat¬ 
ically generate ObjectPro code. New tools make it easier 
for the developer to navigate through an ObjectPro appli¬ 
cation. The product supports OLE, allowing developers to 

create applications that embed OCX and VBX controls. 

ObjectPro applications will be generic OLE containers, so 
that other OLE applications, such as Excel, can be embed¬ 
ded. 

ObjectPro v2.0 costs $2995 per unit; there is no 
charge for runtime licenses. For more information, con¬ 
tact Trinzic Corporation, 701 University Avenue, 

Palo Alto, CA 94301, (617) 891-6500. 


Zinc Updates C++ Class Library 



Zinc is a C++ application framework that lets develop¬ 
ers create globally-enabled, object-oriented, cross-plat- 
form applications with one set of source code. Version 

4.1 features a new IMAGE object that displays large bit¬ 
maps from native file formats, a new FILE object that pro¬ 
vides portable binary file I/O on any operating system, 
CTL3D support for Windows, easier function names, and 
dot-matrix printer support for DOS. 

Zinc Application Framework is licensed per devel¬ 
oper, per platform. The Zinc Engine (required) costs 
$499; a DOS, Windows, OS/2, or Macintosh "Key' costs 
$499; and a X/Motif, Curses, or NEXTSTEP 'Key' costs 
$1,499. For more information, contact Zinc Software Inc, 

405 South 100 East Pleasant Grove, UT84062, 

(801) 785-8900;fax (801) 785-8996; BBS (801) 785-8997; 
CompuServe: GO ZINC; Internet: info@zinccom. 


ObjectSpace Ships Enhanced Standard Template Library 


Systems<ToolKit> is a set of cross-platform C++ foun¬ 
dation classes from ObjectSpace, Inc. Systems<ToolKit> 
contains a thread-safe implementation of the Standard 
Template Library (recently incorporated into the ANSI 
draft standard). Besides STL, the library provides a set of 
components for interfacing with operating system fea¬ 
tures such as files, sockets, threads, and processes. Code 
written using the Systems<ToolKit> cross-platform 

classes supports multiple threads and works without 
modification across UNIX, Windows 3.1, Windows NT, 

Windows 95, and OS/2. 

Systems«Toolkit» costs $375; users of ObjectSys- 
tems can upgrade for free. For more information, contact 

ObjectSpace, 14881 Quorum Drive, Suite 400, Dallas, TX 

75240, (214) 934-2496;fax (214) 663-3959; 
info@objectspace.com. 


QA Partner v3.0 Features Visual Scripting Language 


QA Partner is an object-oriented, automated testing 
package for testing client/server applications across mul¬ 
tiple platforms. In this version, the product's 4Test script¬ 
ing language has been transformed from a C-like 
language to a visual scripting langauge, while still sup¬ 
porting existing scripts. This version also introduces an 
Automated Testframe feature that enables unattended 
testing and recovery in case of crash. A 'multiple applica¬ 
tion states' feature lets you record an application state 
once and then refer to it in the script. Test script results 

are displayed in a color-coded format to indicate severity 
and type of information. Text and bitmap comparator 
tools are now integrated into the report, displaying the 
specific information attributed to each error. 

Single-user, single-platform licenses range for QA Part¬ 
ner v3.0 range from $2,995 for PC platforms to $6,995 
for UNIX platforms. For more information, contact Seque 

Software, Inc, 1320 Centre Street Newton Centre, MA 

02159, (617) 969-3771;fax (617) 969-4326. 


SQA Ships New Testing Tools 



SQA, Inc. is shipping SQA Enterprise TestSuite, an inte¬ 
grated test suite for automated testing of Windows cli¬ 
ent/server applications. The suite includes SQA Process 

2.0, SQA LoadTest 2.0, SQA Robot 4.0, and SQA Manager 
4.0. SQA Process is a training course in a formal testing 
methodology. SQA LoadTest is a point-and-dick tool for 
performing load, stress, and multi-user testing of Win¬ 
dows client/server applications on TCP/IP, NETBIOS, or 
IPX/SPX networks. SQA Robot provides Windows test 

automation, including object-level integration with popu¬ 
lar client/server development tools. SQA Manager uses a 
networked test repository to manage test planning and 
development, reporting and analysis, and defect manage¬ 
ment. 

For more information, contact SQA, Inc, 10 State 
street Woburn, MA 01801, (800) 228-9922; 
fax (617) 932-3280; info@sqa.com. 
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ErgoPLAN Control Provides Scheduling 

Component Graphics has created a new control for 
scheduling applications. The ErgoPlan control gives the 
user a point-and-dick interface for manipulating the 
schedule; you can create, update, and delete time slots 
by clicking and dragging the mouse cursor. All these user 
actions result in custom events your program can act on. 
You can configure the interface to display any number of 
days and any number of hours within a day. 


ErgoPLAN costs $69.95 as a VBX, $79.95 as an OCX, 
or $99.95 for both. For more information, contact Compo¬ 
nent Graphics, Inc, 763B Foothill Boulevard, Suite 7 28, 
San Luis Obispo, CA 93405-1617, (800) 355-6738 or 
(805) 783-0813 (outside the U.S.);fax (805) 783-0827; 
email: moreinfo@cginccom; http://www.cginccom. 


sp_Assist Aids Stored Procedure Management 


Sheridan Software Systems has introduced sp_Assist, 
a new tool that helps developers create, code, and man¬ 
age SQL-stored procedures and other SQL objects, such 
as tables and triggers. sp_Assist's private multi-user data¬ 
base and facilities for synchronizing SQL code allows mul¬ 
tiple developers to work with SQL objects across multiple 
SQL servers. The product can generate both SQL and Vis¬ 
ual Basic code, including INSERT, UPDATE, SELECT, and 


DELETE SQL stored procedures or queries, as well as the 
Visual Basic code needed to call them. The program of¬ 
fers 'wizards' and point-and-dick coding functions to 
speed development. 

For more information, contact Sheridan Software Sys¬ 
tems, Inc, 35 Pinelawn Road, Suite 206E, Melville, NY 
11747, (516) 753-0985; BBS (516) 753-5452; 
fax (516) 753-3661; CompuServe: GO SHERIDAN. 


Watcom Updates FORTRAN, C/C++ Compilers 


Watcom, a division of Powersoft and Sybase, has re¬ 
leased Watcom C/C++ vl 0.5, the latest version of their 
multiplatform development system. This version features 
MFC and OLE support, and includes Blue Sky's Visual Pro¬ 
grammer, a visual development tool and MFC code gen¬ 
erator for 16-bit and 32-bit Windows applications. The 
product can produce code for Windows 95, Windows 
NT, Windows 3.x, Win32s, OS/2 Warp, extended DOS, 

16-bit DOS, OS/2 1 .x, and Novell NLMs. 

Watcom has also released Watcom FORTRAN 77 
vl 0.5, a new version of their FORTRAN compiler, that in¬ 


cludes a graphical IDE for developing both character¬ 
mode and GUI applications on a variety of platforms. 

The version includes improved optimization, such as re¬ 
cursion elimination and floating-point scheduling. 

Watcom C/C++ vl 0.5 costs $350 ($199 for a 'com¬ 
petitive upgrade' within North America); existing users 
can upgrade for $129. Watcom FORTRAN 77 vl 0.5 costs 
$499; upgrades are $199. For more information, contact 
Watcom, 415 Phillip Street, Waterloo, Ontario, Canada 
N2L 3X2, (519) 886-3700;fax (519) 747-4971. 


EMS Adds Delphi, Clarion, and NT Tools Libraries 


EMS Professional Shareware is shipping three new 
collections of shareware: the Delphi Utility Library, the 
Clarion Utility Library, and the NT Utility Library, each 
with over 100 tools for programmers and consultants. 

All three libraries come with an indexed database to help 
you locate files of interest via multiple criteria. 

The Delphi Utility Library includes products from cate¬ 
gories such as BDE, Btrieve, custom controls, data com¬ 
pression, database, graphics, network, user interface, 
Winsock, and others. The Clarion Utility Library includes 
batch files, conversion utilities, patches, source utilites, 


templates, and more. The NT Utility Library includes ap¬ 
plication launchers, archivers, fonts, network drivers, 
patches, programming tools, TCPI/IP, text editors, and so 
on. 

Libraries on CD-ROM are $59.50 for any one, $25 for 
each additional. All come with a 30-day, money-back 
guarantee. For more information, contact EMS 

Professional Shareware, 4505 Buckhurst CL, Olney, MD 
20832-1830, (301) 924-3594;fax (301) 963-2708; 
Internet: ems@wdn.com; 
http://www.xmission.com/- wwwads/ems. 


DDF Sniffer Sniffs Out Btrieve Database Structure 


Smithware has released a new Btrieve database defi¬ 
nition tool called DDF Sniffer, an add-on to their DDF 
Builder. DDF Builder automatically builds a data diction¬ 
ary for Btrieve files, making them accessible with applica¬ 
tions such as Access, Visual Basic, Delphi, and others. 
DDF Sniffer helps developers figure out the structure of 
complicated Btrieve databases. 


DDF Sniffer costs $199 and requires DDF Builder, 
which costs $129. For more information, contact 

Smithware, Inc, 2416 Hillsboro Rd„ Suite 201, Nashville, 
TN 37212, (615) 386-3100, fax (615) 386-3135; 
CompuServe: 75470,546; MCI Mail 590-5654; 

Internet: info@smithware.com. 
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Black Ice Ships Fax Toolkit for NT 


The Fax Toolkit is a set of tools for adding fax facili¬ 
ties to Windows applications, now available for Win¬ 
dows NT as well as Windows 3.1. The toolkit contains 
three components: a fax send/receive driver and inter¬ 
face library, a generic print capture driver, and user inter¬ 
face builders. 

The fax send/receive driver supports Class 1, Class 2, 
and Class 2.0 fax modems. This release adds Binary File 
Transfer (BFT) compliant with CCITT .434, a mode that 
lets modems send color images to other BFT compliant 
modems. An included C++ class library provides send/re¬ 
ceive queue management, dynamic fax modem configu¬ 
ration, comm port control, and support for over 42 page 
sizes. The library provides both C++ and C interfaces, 


and works with any language that can call DLLs. The 
monochrome or color generic print capture driver cap¬ 
tures print output from any Windows application and 
generates fax output, allowing your application to pro¬ 
duce fax output from any Windows application that can 
print. The TIFF and image SDK Plus component of the 
toolkit lets developers create a user interface for their fax 
applications. 

The components can be purchased separately, or to¬ 
gether for $2500 for Windows ($3500 for NT), royalty 
free. For more information, contact Black Ice Software, 
Inc, 292 Route 101, Salzberg Square, Amherst, NH 
03031, (603) 673-1019; fax (603) 672-4112. 


New Custom Control Handles Multi-Port Dialogic 


Parity Software has released VoiceBocx, a new cus¬ 
tom control for call processing applications written in Vis¬ 
ual Basic, Delphi, Visual C/C++, or other environments 
that support VBXs. Developers can use VoiceBocx to cre¬ 
ate multi-port Dialogic call processing applications, such 
as office voice mail, banking by phone, automated order 
entry, phone classifieds, and fax-back. 


VoiceBocx VBX costs $595 for a 2-line system, and re¬ 
quires a Dialogic voice board. For more information, con- 
tart Parity Software, 870 Market Street, Suite 1155, 

San Francisco, CA 94102, (415) 989-0330; 
fax (415) 989-0441. 


EVOLVE Provides Xbase Add-On to Multi-Edit 


EVOLVE v7.0 for Windows is an add-on for Multi-Edit 
for Windows that can be used with any object-oriented 
programming language, but it is specially designed to 
help Xbase programmers increase productivity by auto¬ 
mating various coding tasks. A 'CommonTooIs template 
environment' provides source code templates for visual 
controls supported in many popular Xbase programming 
languages for Windows and DOS. This version can intelli¬ 
gently reformat multi-line commands based on the key¬ 
words found in the command line. EVOLVE can also 


automatically change various configuration elements 
when the developer switches to a different dialect of 
Xbase. 

EVOLVE v7.0 for Windows costs $149, or $319 bun¬ 
dled with the latest version of Multi-Edit for Windows. 

For more information, contact American Cybernetics, 

1830 W. University Drive, Suite 112, Tempe,AZ85281, 
(602) 968-1945;fax (602) 966-1654; 

CompuServe: CO CYBERNET; Internet: tech@amcyber.com. 


Silverware Updates Windows Com Toolkit 


Silverware Inc. has released the Silverware Windows 
Communications Tool Kit v5.01, a multi-language com¬ 
munications DLL for Windows programmers. The library 
now includes a high-level dialog box developers can use 
to prompt users for COM port selection, UART settings, 
auto dialer, modem defaults, file transfer options, and 
more, with a single function call. The library supports 
more than two COM ports, multi-port boards, hard¬ 
ware/software flow control, and file transfers. Protocols 
supported include ZMODEM, XMODEM, 1K-XMODEM, 


YMODEM, YMODEM batch, YMODEM-G, YMODEM-G 
batch, and ASCII. ZMODEM file transfer handles crash re¬ 
covery, 32-bit CRC error checking, and wildcard transfers. 
X-YMODEM transfers now support program-definable 
checksum or CRC error checking. 

The Silverware Windows Communications Tool Kit 
v5.01 costs $299. For more information, contact 
Silverware, Inc, 3010 LBJ Freeway, Suite 740, Dallas, TX 
75234, (214) 247-0131;fax (214) 406-9999; 

BBS (214) 247-2177; http://rampages.onramp.net/~silver. 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


From: Mark S. Edwards 
<marke@firefox.co.uk> 

Subject: Re: Article: Debugging Fixed 

Memory 

Ron, 

You really know how to pick a 
subject, don't you! I really must 
praise W/DDJ for the number of 
times you have tackled this subject 
and expanded the public domain 
knowledge of the subject. This article 
neatly sums up existing knowledge 
and explores some of the loose ends. 

I first became involved in these is¬ 
sues over two years ago, when I had 
to port some TSR functionality into a 
DLL. Since the TSR actually used 
Novell's IPX/SPX at its bottom layer, 
you can imagine some of the late 
nights I went through. Trying to work 
out if the problems were mine, Mi¬ 
crosoft's, or Novell's was not easy. 

You may find it interesting to re¬ 
view the stages that the development 
went through and the insights that 
various W/DDJ and MSJ articles gave 
at the time. 

1) I'm porting a TSR to a DLL, I 
can get rid of the buffer limitations in 
the TSR. Windows has all the mem¬ 
ory I could ever want, hasn't it? Oh, 
since I have interrupt callback rou¬ 
tines I'd better make the code seg¬ 
ment fixed as well. 

2) This DLL seems to work OK, But 
why is Windows reporting out of en¬ 
vironment space? Oh dear, Heap- 
walker shows that my code and data 
segments are about 60K apiece and 
why are they in DOS memory? 

B) Right, let's split the code up so 
that only the interrupt-time functions 
have fixed code segments. 

4) I can make these data struc¬ 
tures using GlobalAllocO instead of 
using DGROUP fixed arrays. I'm calling 
Global AllocO with GMEM_FIXED, why is 
it still in low memory? 

5) Matt Pietrek introduces BE¬ 
LOW! MB in MSJ Oct. 93. This ex¬ 
plains a few things, let's switch to 
Global AllocO with GMEMJND. 

6) Much better, the DOS memory 
footprint is down to about 15Kb. But 
why does it crash every now and 
again? Uh-oh, Novell's drivers can't 
always cope when some elements 


are above 1 Mb. Bring these elements 
below 1Mb, change to using string 
tables to remove string literals from 
the Dgroup. DOS memory footprint is 
now much more acceptable at 8- 
10Kb. 

7) Acott and Spooner article in 
W/DDJ. A magnificent insight into 
perverting the Windows memory al¬ 
location functionality. A bit of mess¬ 
ing around and the DOS footprint is 
now 2.5Kb. 

Matt Pietrek's last article in MSJ 
May '95 is a nice extension to his 
earlier article, and running his 
FIX! MB utility shows that the hard- 
won knowledge about DLLs and 
Windows memory actually works. 

It would have been nice if Mi¬ 
crosoft had provided all the informa¬ 
tion in the first place, but one gets 
the impression that nobody inside 
Microsoft actually understood the 
subject - I think ail the more capable 
people in OS development got 
moved quite early to the NT team. 

Keep up the good work. 

Regards, 

Mark 

Thanks for sharing your own experi¬ 
ence. It always makes me feel a little less 
dense to hear I'm not the only one who 
has stumbled over some particular piece 
of the great Windows programming puz¬ 
zle. -rib 


Sb: Compiler Optimization Bugs 
Fm: David Lowndes [100524,3072] 
Ron, 

In this month's W/DDJ you've 
asked for issues raised in the letter 
from Dan Daly (June 1995). i think 
you may have opened the floodgates 
on this one, but here are my feelings: 

There is a clear difference be¬ 
tween an optimizer bug and the am¬ 
biguity involved (in C especially) to 
generate inappropriately optimized 
code. 

The latter case I feel is an accept¬ 
able risk in writing code that could 
be ambiguous. Here it's down to the 
developer to write code that isn't 
subject to the whims of the op¬ 
timizer. You need to learn what an 
optimizer can do, in order to write 
your code so that it isn't subject to 
these types of problems. Microsoft 
have been quite good in this respect, 
as they documented in older versions 
of their compiler (and in articles in 
MSJ] what to expect of their com¬ 
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piler's optimization techniques when 
you use different compiler flags. 

The former case, where a perfectly 
acceptable piece of code compiles 
into incorrect assembly code, is a 
bug, no doubt about it. I've used MS 
C since V5.1 and in each 16-bit ver¬ 
sion I've encountered different opti¬ 
mization bugs so that I've almost 
given up expecting not to have any 
problems. I'd reported each bug that 
I found, and they did appear to be 
fixed in successive versions - only to 
be replaced by different bugs in the 
newer version. While I can only 
speak in detail on MS C I expect that 
the other vendors products have 
similar problems - perhaps you have 
experience of that. 

I can sympathise with the com¬ 
piler writers: it must be difficult to 
produce optimized code for the 16- 
bit Intel architecture. Like yourself, I 
do wish that the vendors would pub¬ 
lish bug lists (and make them readily 
available) so that we can be aware of 
the problems and not have to dupli¬ 
cate effort. I remember that Intel pro¬ 
duced (and circulated) lists of known 
problems in their PLM & C' compil¬ 
ers. This at least helped you to iden¬ 
tify any potential problem areas in 
your own code. I guess it's too much 
to hope that MS, Borland, etc. would 
do the same? 

David Lowndes 

Programmers' love/hate relationship 
with compiler optimization has been 
around far longer than I've been a pro¬ 
grammer. Compiler writers certainly 
have a tough job, especially trying to im¬ 
plement the moving target of C++ on 
the Intel architecture. Still, I believe that 
compiler vendors could inexpensively 
manage their relations with program¬ 
mers in such a way that compiler writers 
would get critical information (bug re¬ 
ports) more efficiently and likewise pro¬ 
grammers would get the information 
(up-to-date lists of known bugs) crucial 
to making best use of the compiler, -rib 

[Editor's note: the following letter, 
from Philip H. Taylor, Jr., was written in 
response to a reader letter and my reply 
on page 76 of the March 1995 issue. 
The reader wrote to complain principally 
about the source code in Mr. Taylor's 
book 3D Graphics Programming. Mr. 
Taylor's letter was over 45 pages long, 
as it included much compiler output. I 
have edited it for brevity, but have made 
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Prepare for the Lotus Notes 
Certification Tests. 



Developer's 

Marketplace 


Lotus Development and Drake 
International charge $270-$450 to 
get certified on Lotus Notes. Isn’t 
it worth $45-$60 to prepare? 


Consultant, 
Application Developer, 
Server Administrator PreTests 
(over 480 questions) 
cost just $45 each 
or buy the Specialist PreTest 
(over 720 questions) for just $60. 

These Lotus Notes databases allow 
you to take and grade the Pre Tests as 
many times as you want or need to. 


Send check or money order to: 

Reality Bytes 

28 South Main Street 
Randolph, MA 02368 
(Please share this ad with a friend.) 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 

Call TODAY for a FI 

ULTRA 

LEE special report! 

Fax: 214-724-0375 

CompuServe: 71223,634 

C 75028 

Financial Systami 

1633 Arrowhead Dr, Flower Mound, T> 
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Bar Codes Can Be Fun! 
Honest. 

If you can change fonts, 
you can create bar codes. 

Code 39, UPC, POSTNET, 
and other symbologies. 

8oo 48-ASOFT 
206 932.4030 
azalea azalea@igc.apc.org 



THE DEFINITIVE GUIDE TO 
PROGRAMMING IN 32-BITS 

The Revolutionary Guide to 
Win 32 Programming with Visual C++ 

* By one of Microsoft's top 
programmers in the 
Visual C++ team 

* Full coverage of MFC 3.1 
programming for Windows NT 3.51 
ana Windows 95 

* Includes many 
undocumented features 

* CD-ROM with source 
code examples 

Mike Blaszczak ISBN 1-874416-47-8 S44.95 



TO ORDER 

Tel. 800 937 5557 
Fax. 800 PRI ORDER 

VISA MASTERCARD AMEX DISCOVER 


WROX 


QUOTE CODE CL27 FOR FREE FREIGHT 


For more information or a free catalog of 
Wrox Press programming titles call 800 814 4527 

WORLD CLASS PROGRAMMING BOOKS 
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Mr. Phelps Offers : 

Installation Protection 


- Disable Installation Program 

- Date-dependent Password 

- Uninstall Requirement 

Executable Copy Protection 

- Installation Dependence 

- Tamper Detection 

Executable Disabling 

- Based On Number of Runs 

- Based On Installation Date 

- Re-Enable With Your Passcode 

Full 'C Source For Dos and Win S99 
Come s With Configuration Utilities 

Lever 800-638-7250 
Software 315 - 733-9541 

Systems 
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UNIVERSITY EjfW ASHINGTON 

College of Engineering 

The Department of Technical Communication 

presents 

a two-day course: 

Designing and Writing Effective 
Online Help and 
Online Corporate Information 

for more information, contact 
Susan G. Stone 

Engineering Professional Programs 

Tel. (206) 543-5539 
Fax (206) 543-2352 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 

Tel: (905) 474-1990; (800) 388-2475; FAX: (905) 474-9223 

e-mail: dm@sangoma.com; website: www:sangoma.com 
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Z Employment Service 


SALARIED SOFTWARE 
DEVELOPMENT AND 
SUPPORT ENGINEERS 


Clients and affiliates nationally... 
Clients pay our fees (always), and 
your interview and relocation 
expenses (usually). 

RSVP SERVICES 

trusted bu computer professionals 
since 1966 


Ref: WDDJ 

PO Box 8369 Cherry Hill NJ 08002-0369 
Voice: 800/222-0153 
Fax: 609/667-2606 
Internet: npa1621@connectinc.com 


mail/fax/email resume y 
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every effort to leave most of the text un¬ 
changed.] 


From: Jim Conyngham 
<72040.3361 @compuserve.com> 

To: wdletter@rdpub.com 

I very much agree with everything 
you said in your reply to Dan Daly's 
rather puerile flame (June 1995). As a 
professional software developer, I 
firmly believe: 

• Bugs are bad. 

• Bugs make customers mad. 

• Bugs cost money. 

• Bugs ought to be fixed. 

I very much much share your expec¬ 
tations. They do not seem outra¬ 
geous to me. However, I fear you 
and I are out of step with the rest of 
the software industry. If a paying cus¬ 


tomer finds a bug, then in the ideal 

world, the vendor would: 

• politely acknowledge the bug re¬ 
port. 

• fix it in the next release, if possi¬ 
ble. 

• give serious known bugs at least 
as high a priority as implementing 
a sexy new feature. 

In the real world, what happens, of 

course, is: 

• you get completely ignored. 

• the tech support person will tell 
you it's not a bug. 

• the tech support person will tell 
you it's your fault. 

• the tech support person will tell 
you to wait a couple of months 
and see if it's fixed in the next re¬ 
lease. 


• the tech support person will tell 
you they've passed on the report, 
in which case you will never hear 
anything further. 

What really yanks my chain is 
when I go to the trouble of tracking 
down and documenting a compiler 
bug, jump through all the hoops nec¬ 
essary to submit a bug report (down¬ 
load these two documents; fill out 
the four-page form, attach your auto¬ 
exec.bat, config.sys, and MSD files; 
and email the whole thing to our 
automated server), and then get com¬ 
pletely ignored! 

On the other hand, I can sympa¬ 
thize with the vendor's plight. More 
than 90 percent of tech support re¬ 
quests are from marginal incompe¬ 
tents who haven't read the manuals 
or help files and want the tech sup- 
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DRS OCR TOOLKIT 


With its flexible C language API, I.R.I.S. 
has been recognised as being one of the 
most popular and easy to integrate OCR 
packages for Office Automation, DTP, 
Banking, Fax and Database applications. 
I.R.I.S. now offers a complete range of 
OCR engines for full page reading through 
to fast, high performance single line and 
index field reading applications. 

I.R.I.S. technology incorporates Omnifont 
techniques, Linguistic analysis and 
powerful Learning capabilities and supports 
recognition in 29 different languages 
(including Eastern European, Greek and 
Cyrillic). Available for many platforms 
including : PC, UNIX Workstation, MAC & 
PowerPC. 

Call us I 


I.R.I.S. (U.S.A.) 

Tel (408)255 7190 
Tel: (407) 395 7831 

I.R.I.S. (Europe) 

Tel (32) 10 45 1364 
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Fax :(408) 255 7140 
Fax (407) 995 9290 


Fax (32) 10 45 3443 


WINGRAF 2.0 INGRAF 7.0 

(Win 3.1, Win95, WinNT) (DOS/DOS extenders) 


WINGRAF & INGRAF are Graphics libraries 
for Scientific, Engineering and Business 
applications. Each library contains over 150 
routines to draw linear, log, log/log, polar, 
smith, bar, pie, scatter, high-low-close plots 
on VIDEO, PRINTERS and PLOTTERS. 
C, PASCAL, DELPHI, BASIC, and 
FORTRAN language versions. 

NO ROYALTIES 
FULL SOURCE CODE 

Sutrasoft 

P.O. Box 1733 

Sugar Land, TX 77487-1733 
TEL: (713) 491-2088 
FAX: (713) 240-6883 
76163.1164@COMPUSERVE.COM 
VISA, MC, AMEX & DISCOVER 
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Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. 

“Insanely Great” 

Software Development Magazine 


Berkeley Toolworks 

800-593-5103 510-649-9891 apivis@berktool.com 


$199 + 18 ship. 

MasterCard, Visa 

30 day money-back guarantee 
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Interactive Help For Windows 


Transform WinHelp from a 
passive display viewer to an 

"ijrj'ih-rr- f INTERACTIVE APPLICATION DRIVER! 

IH - the new WinHelp DLL extension language is 
the perfect tool for WinHelp interactive applications. 

Use IH to: 

• Design and process forms & dialogs using option lists, 
edit boxes, input validation, etc. 

• Create dynamic help topics using dynamic text fields 

• Embed video clips in WinHelp topics and activate them 
from your procedures 

• Connect to external databases using a dynamic 
dispatch function mechanism 

• Trap and handle WinHelp events using a structured language 

• Expose and use the WinHelp internal extension functions 

• Activate macros automatically upon topic entry and exit. 

Get Interactive Help for Windows 
for $149 ! 

lyperAc 1 


P.O.Box 5517. Coralville, IA 52241. USA. 
TeleFax. (319) 351-8413. CompuServe 76350,333 
Internet: rhalevi@hyperact.com 
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Dr. DeeBee™ 
ODBC Tools 

Tools for ODBC^ development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


Call for a Frse ODBC prescription! 



W 

SyVMAE, 


Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 


RO, Box 91 Kendall, Cambridge, MA 02142 

G17- 497-1376 Fax 617-497-8729 
http: //www. syware .com/drdeebee/ 
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Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 for 
Windows, $129.95 for Windows 
NT. See for yourself. Download a 
demo copy. 

Try 3 complete, free evel copy tonight! 

BBS: 206-935-5198 
AOL: WindowWare 
CompuServe: WINAPA, Sec. 15 
FTP: www.windowware.com /wwwftp/wilson 
WEB: http://www.windowware.com/wilson/pages/ 
Orders: 1-800-938-4599 
Wilson WindowWare, inc. 
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WINDOWS DEVELOPERS 

As a headhunter focusing on one area of 
software engineering, I believe I can find you 
the best opportunities. Through constant 
networking I learn of positions all over the 
country. All fees are paid by the client 
company. The market is excellent for talented 
windows developers. Give me a call at 
1-800-638-8903. (CompuServe 73172,663) 
— Gary Patton 


THIS IS YOUR FUTURE 


Sareer 

MARKETING 

0SSOCIATES 
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C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

■ C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional ($2991 DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauaa 
ONT, Canada Voice/Fax OOSFfl 58-44 
^fMM^^)emo/BBS(SHD5P; 
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The best embeddable 
macro language 
just got better: 

SBL Version 4,0 


All Major Platforms 

Windows, Windows 95, Windows NT, 
Windows 32S • Unix • Macintosh, 
Power PC • NLM • OS/2 

New OOP Capabilities 

Supports polymorphism, operator 
overloading, virtual functions. 

The Best ISVs Turn to SBL 

When they need to embed a scripting 
language in their bestselling products, the 
industry leaders turn to us: Attachmate, 

✓v Btrieve, Cognos, Novell, Oracle, 

- ^ Platinum, Solomon, Wall Data, 
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ABSOLUTELY, 

POSITIVELY, 

NO MORE 

vls T il*0. 

e r r or s / 


$5/disk, 

one issue per disk 
or ALL of 1994 
or 1993 for $20! 

Call today! 

913 - 841-1631 

FAX 913-841-2624 


Windows 

□ DEVELOPER S JOURNAL 

Advanced. Serious. Technical. 

Suite 200, 1601 West 23rd Street 
Lawrence, KS 66046 


The Fastest xlBASE Engine 

CodeBase provides C, C++, Visual 
Basic and Delphi programmers 
with the fastest XBASE compatible 
database engine. Get multi-user 
compatibility with FoxPro, Clipper 
and dBASE files. And it's portable 
from DOS to Windows to UNIX! 
FREE 30 day trial 

Included are data aware controls for 
Windows, a powerful report writer 
and the entire set of source code! 
All the popular C/C++ compilers are 
supported. Scale from single user 
to client/server without any source 
code changes. 

Royalty Free distribution. 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
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Little Big 
LAN 

Costs just $75 per LAN! 

* Connect via Ethernet, Arcnet, 

* via serial, parallel, or modem 

* Low memory use - about 50k 

* Dos 6, and Windows compatible 

* Link up to 250 nodes, still $75 

* Share almost anything 

* Netbios and file/record locking 

* Version 2.0b 

Skeptical? We make believers! 

Information Modes 
P.O. Drawer F 
Denton, TX 76202 
817-382-7407 Fax 
1-800-628-7992 
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C, C++ and Delphi Libraries 
for Windows and NT 

G_FFT Class Library 3.10: Extremely high 
speed Signal Processing routines, Real, 
Complex FFT, Correlation, Convolution, 
Amplitude, Power Spectrum, Filtering, 
Decimation, Data Smoothing, Windowing, 
sorting and more. $149 
G_FFT Professional: Includes G_FFT and 
supports Virtual Memory. Converts over 2 
billion data points. $199 
OOPIot Class Library 3.10: Plotting and 
charting, Linear, Log, Log-Log, Scatter, Bar, 
Pie, Origin setting, Scaling, Real 
Coordinates not integer, MDI support and 
much more. $149 

OOParser Class Library: Expression and 
function evaluator with 1,2, & 3 variables 
and unlimited parameters. $79. 

Sigma Software, Inc. 

15779 Columbia Pike, Suite 360 
Burtonsville, MD 20866 
Call or Fax your order: 301-549-3320 
BBS 301-549-4161 
Download Demo from our BBS. 
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port people to write or debug their 
code for them. Legitimate bug reports 
just get lost in the noise. And it's un¬ 
realistic to expect compiler vendors 
to provide the 'world-class customer 
support' they advertise on the small 
profit margins they get. Good or bad, 
customer support is expensive. Just a 
few contacts can wipe out all the 
profit from a sale. (Which brings us 
back full circle to: Bugs cost money.) 

There are any number of villains 
we can point to: The dumbing-down 
of the software profession over the 
years; a market that forces vendors 
to compete on price and features in¬ 
stead of quality; tech support depart¬ 
ments that don't; etc., etc. 

About the only positive thing we 
can really do is give credit, thanks, 
and support to vendors when they 


earn it. Perhaps with a little encour¬ 
agement, vendors could be gotten 
over the fallacy of thinking that ad¬ 
mitting their bugs makes them look 
bad. For example, let's give some 
credit to Microsoft for publishing its 
'Knowledge Base,' which is in fact a 
public bug database such as you pro¬ 
pose (although a sadly incomplete 
one). Have you considered offering 
Microsoft your W/DDJ SDK Annota¬ 
tions for inclusion on their developer 
CDs? (After you've published them 
yourself, of course!) 

Sincerely, 

Jim Conyngham 

I agree, kudos to Microsoft for pub¬ 
lishing their Knowledge Base. While I'm 
at it, although none of the compilers I 
use (Borland, Microsoft, Symantec, and 
Watcom) provided very good online sup¬ 


port the last time I checked, Watcom 
seems to have the most aggressive bug¬ 
fixing policy, with frequent updates, 
available for the price of the download - 
kudos to Watcom. I'm disinclined to offer 
Microsoft the chance to include our an¬ 
notations, simply because they own the 
source to the help file that these annota¬ 
tions are intended to 'patch" - they 
should just fix and redistribute the origi¬ 
nal! -rib 


Subject: buggy software and vendors 

hoarding source 

Ron, 

Dan Daly had a letter in the June 
1995 issue about bugs and 
workarounds. Please give the issue 
someone is commenting on!! (I 
couldn't find it). [Editor's note: the col- 
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S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer’s 
Mind* 


When the country’s 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


is Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


Add ZIP (and UNZIP too!) to 
your Windows applications! 


.DynaZIP 30 

| Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developers tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more “shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Hobert 

World's Fastest Sorting Utilities 
$149 

Postman’s Sort is a linear time general purpose 
file sorting utility for all Intel platforms. 

* Typically 3 times faster than other products. 

* No limit on file size 

* Fixed, Variable, and Data Delimited file types 

* Field types accomodated include alphabetic, 
signed and unsigned binary, packed decimal, 
ascii numeric, ieee floating point among others 

* Flexible and Natural specification of sorting 
fields and collating sequences from command 
line or command file 

* Price includes executables and DLLs for DOS, 
Windows, NT, Win95 and OS/2 and 
distribution license for 50 copies 

3949 1/2 foothill road, santa barbara, California, 93110 
telephone (805) 569-3793 www.silcom.com/~ramey 
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Proindex 

- 

Full-Text Indexing and Retrieval 
Development Toolkit! 



• Perfect for CD-ROM applications and 


dynamic data management 


• Unequaled indexing speed! 

• Fast complex searches 

• Handles wildcards, phrases, proximity and more! 


• Use with C/C+ + , VB, Delphi, etc. 

• LAN and multi-user support 


• DOS, Windows, Windows NT, Windows 95, 


OS/2, NeXT, Unix, and Macintosh 



Call today for a FREE demo and information! 

InfoSphere 

801-221-5902 

RO. Box 225, Pleasant Grove, UT 84062 
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Lexicus Longhand 

Handwriting Recognition Software 

Windows Developer Version 




Lexicus Longhand 
recognizes 

your cursive 


Software software 
Softened softened 
Solitude solitude 
Softener softener 
Sentence sentence 
Software software 


, 3 o f t w.a 

re. . . . , 


o* I I c—a t 


recognizes cursive, print and mixed styles 
• dictionary building tool included 

1-800-LEXICUS or 415-462-6800 
internet: info@lexicus.mot.com 
url: http://www.mot.com/lexicus/ 
Lexicus, A Division of Motorola 




MOTOROLA 
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| Moving to 
; WinHelp'95 



Easily 
Move to 
Windows 95 
Help 


The Moving to WinHelp ‘95™ Kit automatically 
converts your existing Windows 3.x Help systems 
to Windows 95 Help systems. 

Automatically adds Windows 95 features to your 
Help systems and updates your source files. 
Works with all Help systems whether they were 
produced manually or with a development tool. 
Includes Mastering Windows 95 Help-the Official 
Book for Help Authoring. 

Call 1-800-718-4406 

now for the fastest and easiest way to 
move existing Help systems to Windows 95. 

BLUE SKY SOFTWARE 

Inti: 1-6194596365 Fax: 1-6194596366 


Don’t gamble with your 
job search. 

Use DICE. 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 


Data processing 

I NDEPENDENT 

Consultants! 

E XCHANGE , 

A Service of D&L Online, Inc.: (515) 280-1144 


Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


4. Add Text-to-Speech 
capability with VoxFonts ™, 
our text-to-speech library! 

5. Audio ToolBox™ 
converts between Multimedia 
Wave (16, 8 & MS ADPCM), 
unsigned 8, linear 16, CCITT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK\ 

iivinaJfIKIMMWSfSVni 

VISI, 2118 Wilshire Blvd, #973, Santa Monica, Ca 90403; 310-392-8780 
Fax 800-234-FXIT / BBS: 310-392-6610 (Download our Working Demos) 


1. Create fantastic prompts 
and save time with VFEdit®\ 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL ™, our Tel I/F 
Dynamic Link Library. 

3. Scribe plays digital audio 
files without voice hardware! 


□ Request Reader Service #291 □ 


□ Request Reader Service #152 □ 


□ Request Reader Service #159 □ 


Windows hardware access... 


WinStar Hardware Classes,,, 

C++ classes and C API for hardware 
access from Win32 applications. 
o Port and physical memory access 
o Support for interrupt handlers 
o Hardware Viewer utility included 
o Supports Windows 95 and NT 
o No DDK required 


For NT DDK development... 


Device Talk,„ 

Single-machine debugging tool for NT 
device driver develepment. Trace, 
breakpoint, and device extension 
symbolic viewing support. 




id 


WinStar Technologies JM 

(415)647-2815 
CompuServe: 74367,1773 
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| Does your company 

provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows" 

□ DEVELOPER S JOURNAL 

Advanced. Serious. Technical. 


Call 913-841-1631 today for 
information about 
advertising opportunities in 
Windows Developer’s Journal. 


I Brian Osborn - Continental Europe. 

+49 431-801740 

I Ed - East I Christine - Midwest I Julie - West 
913-841-1622 1913-841-6733 1913-841-1626 



Free CDROM! 


Sampler CDROM: You get useful sam ples frorr 
44 CDROMs + $5.00 check inside- ! i :1 (X 

*Free with regular $5.00 shipping charge 

Cica MS Windows: 2-disc set! 4000 new $29.95* 
prgrms, games, utilities, drivers, code, fonts. 

Simtel MSD0S: Now 2-disc set! 1000 MB $34.95* 
MSDOS shareware (utils, games, code, etc.) 

Hobbes OS/2: OS/2 Mag's Product of the Year! $29.95* 
600 MB of OS/2 Shor^Freeware (2-disc set). 

C Users' Group Library: C Users'Journal $49.95* 
Archive: 10 yrs of C code & articles 
Source Code : 650 MB C, Usenet Unix, DOS $39.95 
Toolkit for Linux: Slackwore 2.0 32-bit 0/S $39.95 
for PC with GNU & XI1. Src. (2-disc set!) 

FreeBSD 2.0: Berkeley BSD, 32-bit 0/S for $39.95 
PC, with GNU & XI1. Full source. 

Internet Info: 12,000 computer, netwak 
Internet documents. FAQ's, RFC's & lEN's 
Space & Astronomy: Thousands of NASA 
images + viewer, 5000 data files, prgrms. 

♦shareware requires separate payment to authors if found useful 

Call Now for our Free Catalog! 1-800-786-9907 

Walnut Creek CDROMH3 36 El MB 
1-510-674-0783 • FAX 1-510-674-08211 
email: orders@cdrom.com 
404 \ Tike Lane, Suite D-692 Concord, CA 94520 I 692 


$39.95 

$39.95 
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1 Dazzle/VB - image manipulation. $199 

' VBIite - print/comm/array/B-Tree index ..$149 

1 ProMath/VB - numerics/statistics. $149 

' FinLib/VB - financial calculations. $149 

' QuickLine/VB - telephony (multi-line) ...$495 

1 SpellCheck/VB - spelling & lookup. $49 

' QB/C/dBase -15 more DOS libraries ...$call 
' Custom - C, VB, ASM programming ... $80/h 


Develop your VB app faster: Get TeraTech 
tools! Can, E-mail or fax us and we’ll mail you a 
free demo disk ASAP. Or for faster service 
download by FTP or from our BBS. Call now! 

800 - 447-9120 ext. 1149 

; Dept 1149,100 Park Avenue, Suite 360, Rockville MD 20850 USA 
1 Int i: +1-301-424-3903 Fax:(301)762-8185 BBS: (301)762-8184 

Copyright TeraTech 1995. AI rights reserved. Trademarics are the property of their hoHers. 
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MGSpell V2.0 

120,000 word dictionary 
Spell Checking/Corrections 
User Dictionaries 
WIN/DOS and Mac Versions 
Use Win version with any DLL compat language 
DOS Version works with C/C++ 

MGSPELL V2.0, Item 11359, $99 

Display-Gif 

Add FULL-Color GIF Display/Import 
Great For Title/Info Screens 
Uses ONLY BGI Function Calls 
Includes SuperVGA(VESA) BGI Driver 
For use with Borland C/C++ only.full source code 

VIEW-GIF, Item 11450, $50 

To order call PSL: 

1-800-242-4775 (713-52+6394) 

Order by item number, this 
number is for orders only. 

For more info contact: 

1-800-270-1394 (31+638-2506) 

76476.1701 ©compuserve.com 
MicroGenesis Software,P.O. Box 25534 
St. Louis, MO 63125 
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umn Dan Daly referred to was in the 
February 1995, 6:2, issue.] As far as 
bugs, and commercial products go, I 
just have to make a few comments. I 
believe in source code. I have no 
beef with commercial products, I just 
think they should provide source 
code at a "reasonable price' (i.e., 
maybe 3x price of the product). 
There are no secrets to a wizard... the 
binary is useful, the source is just a 
means to an end. 

I've been using the GNU suite of 
compiler tools for over seven years 
on a variety of platforms (including 
Sun 4, Sun 3, Sun386i, Solaris, 
MS/DOS), along with a number of 
other vendor compilers. After using 
free software and proprietary soft¬ 
ware, I far prefer freeware. There a 


number of reasons. With proprietary 
software, when you find a problem: 

• you can hope the vendor fixes it 

• do nothing 

• use something else 

With freeware you add the following 
choices: 

• fix it yourself 

• hire someone to fix it. 

I don't agree all software needs to 
be copylefted (anyone who has the 
binary can distribute it, along with 
sources for each binary) but if I buy a 
commercial piece of software, I want 
makeable source. Why? A lot of 
things I want to change may be quite 
easy in a quality piece of software, or 
I might want to answer the question: 
'what is it doing". Documentation is 
often incorrect and/or insufficient. 
Asking for advice is also often a 


waste, unless someone is looking at 
the source. I know very little about 
spare assembly code, since I found 
little need to ever understand the 
output of my C compiler... 

Also, on page 80 of the June 
1995 issue, the trick 

//define CompilerAssert(e) \ 
extern char _Dummy[(e)?l:0]; 

is a problem in gcc. You have to com¬ 
pile with "-ansi -' pedantic options in 
order to get the desired error message 
(this is with the newest gcc). But it's still 
clever (I recall seeing it before). 

marty 

leisner@sdsp.mc.xerox.com 
Member of the League for Program¬ 
ming Freedom 
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HASSLE-FREE 
HARDWARE 
CONTROL 

Win 

REAL TIME TOOLKIT FOR WIN32® 
Windows95 < swrlaBE » NT. 




Spend your time writing your App... not wading through D.D.K. documentation! 
Fast hardware control under Win32® without the DEVICE DRIVER KIT! 


V PORT I/O V MEMORY I/O ■/INTERUPTS 

Also available on: Alpha™, PowerPC™, MIPS™ versions. 



NO RUNTIME ROYALTIES 

• Visa, MC, Approved P.O. • 

73514.132@COMPUSERVE.COM 

OFFICE (206) 771-3610 FAX (206) 771-2742 
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Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

V¥7H AV PO Box 5700 
k_7 V vJ-V^zV Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resume or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 

800-231-5920 Fax 800-757-9003 

CompuServe: 71250,3001 AOLidavesmall 
SPI8, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8, Box 71, San Ramon, CA 94583 
510-733-6168 Beth@spica.bdt.com 
SPI8, Kenmore Station. Box 15225 
Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
SPI8, P. O. Box 202676, Austin. TX 78720-2676 
512-918-3785 lej@zilker.net 
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New Version 3.12 

DOS $249 
Windows $299 
OS/2 $349 
Unix $349 
Visa, MasterCard, American 
Express end Distover Cords welcome. 


Never shell out to 
the O/S again! 
Crusher is a robust 
set of functions 
that provide your 
DOS, Windows, 
OS/2 and Unix 
applications high 
performance, portable 
data compression. 


Features buffer & file 
compression, disk 
spanning, full source 
code and more. 
Windows version 
includes VBX and 
on-line help. 

Free demo on BBS (606) 268-1 251 
Tel (606) 268-1559 Fax (606) 266-0726 


24-hour information by fax 
1-800-234-0141, doc #1151 
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VB Tech Journal says... "I found ProEssentials 
both professional and essential. It's a first- 
class product." _ 

GigaSoft™ 
ProEssentials™ vl .5 

For... 

™ Visual Basic, 

» VC+4-, BC++, 

f Delphi, Gupta, 
I PowerBuilder, 
40 * Clarion, 

» FoxPro, 
dBaseWin, 
and others. 


Windows 3.1 DLUVBX/FLL providing three interactive 
controls: Graph, Scientific Graph, and Pie Chart objects. 
Ideal for information-system, financial, scientific, quality- 
control and data-acquisition implementations. User 
dialogs and popup menus, graph plus table, revolving 
subsets / panning points, smooth real-time, no 
overlapping labels, help, maximization, extensive export 
capabilities, comprehensive hot-spots, zooming, null- 
data, and quick / easy to implement. Call for a free demo 
or download ’pedemo.zip’ from CIS’s VBPJFO forum. 

90 Day No Risk , Aijr\ 

Guarantee! -^e a t0 ° K ' W J>z4 y 

Gigasoft, Inc. 817-431-8470 fax: 817-431-9860 
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The Ultimate High Performance Imaging Toolkit! 


PERFORMANCE 


“ 1 “ 

2 
s 



QUALITY 


AccuSoft Imagedormat Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate 
imaging toolkit solution with the best 
performance, most formats, most 
platforms, best pricing and most 
complete API. Which is why we are 
the leader and why over 5000 
companies have chosen AccuSoft for 
their imaging needs! 

Performance 

AccuSoft has always been known as 
the performance leader. We know 
that you want the fastest imaging 
possible and that fast is never fast 
enough. Therefore, we constantly 
work on improving performance to 
keep us (and you ) ahead of the 
competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 
product quality, which can be seen in 
our unique guarantees, but also 
service quality with our special fast 
delivery program to our top rated 
technical support and rock-solid 
technology. 

Call us today at (800) 525-3577 


Pro Gold 

The Pro Gold versions of our 
imaging toolkits are unbeatable for 
performance and special features like 
scale to gray, sub-degree rotation, 
sub-second decompress & display, 
sub second screen rotation, huge 
image handling and more. If you 
want the best performance available 
anywhere at any price, this is it. 

Cross Platform 

Wouldn't it be nice if you could sell 
your applications on many different 
platforms without having to recode 
the imaging portion? AccuSoft's 
cross platform design is tailored for 
easy porting and since we support 
ALL platforms your products can be 
sold to every market. 

Image Guarantee 

When your image is on the line - 
choose AccuSoft. We guarantee your 
image, in fact we guarantee all your 
images. Our AccuSoft Image 
Guarantee™ has been in effect for 
over four years and states that we 
guarantee to read ANY raster image 
in all 36 formats we support. Not just 


parts of each format, but any type or 
flavor or sub-flavor or sub-format. 
This guarantee means you get the 
highest quality imaging toolkit 
available. 

VBX, OCX or DLL 

AccuSoft has a complete line of 
Visual Basic custom controls that will 
work with VB, PowerBuilder, SQL 
Windows, Delphi, Visual C, and any 
other VBX compatible host 
environment. We also have OCX 
versions for VB 4.0, MS Access and 
more. The VBX and OCX versions 
have over 150 properties and events, 
and are fully interactive. These are 
the most powerful and easy to use 
controls on the market. DLL 
versions with comprehensive & high 
level API's are available also. 

Order Today 

Call today and you can start writing 
high performance imaging 
applications in less than one hour 
with our unique 30 minute delivery 
program! 

AccuSoft 

High Performance Imaging' 


Platforms 

Supported 

Windows 
Windows 95 
DOS 
D0S32 
VBX 
OCX 
NT 
OS/2 
FoxPro 
SUN OS 
SUN Solaris 
HPUX 
RS/6000 
SGI 
SCO 
MAC 

PowerMac 


36 File Formats 
Supported 

TIFF 
JPEG 
Group III 
Group IV 
PCX 
TGA 






Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

©1995 AccuSoft Corporation. All Rights Reserved. All company and brand names are trademarks or registered trademarks of their respective owners. I. Raster only 2. Read only (Does NOT require separate DLL from Kodak.) 


ACCUSOFT 

IMAGE 

GUARANTEE" 


Look for the 
AccuSoft Image 
Guarantee™ 
or the AccuSoft 
trademark on your 
favorite software 
products as a 
statement of 
superior quality. 
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Windows 95: See It All 
With Nu-Mega's Soft-ICE! 


Your 32-bit Application 
Debugger Is Stuck In The Win32 
Subsystem, But The Bugs Aren't! 

When chasing a tough bug through the 
multiple layers of Windows 95, you need a 
debugger that can easily follow it. You need 
visibility and debugging power to chase 
bugs anywhere they go. When your con¬ 
ventional application debugger falls short, 
your only option is Soft-ICE/WIN 95 

System crash bugs are particularly frus¬ 
trating without the right tool. Without visi¬ 
bility and control, these can take days, or 
even weeks to solve. Soft-ICE/WIN 95 
gives you visibility with it's internal system 
commands. It can show you what led up to 
the crash with its back trace history capa¬ 
bility. Soft-ICE/WIN 95 also gives you real 
control because it can debug through any 
code in any part of Windows 95. 

Soft-ICE/WIN 95 sits right on the metal. It 
is not dependent on any system code. Its In- 
Circuit-Emulator (ICE)-like features let you 
debug any Windows 95 code without side 
effects, and without expensive hardware. 

Windows 95 Is Here And 
It Means Change. 

Soft-ICE/WIN 95 understands all of the 
subsystems that make up Windows 95. It dis¬ 
plays relevant information in each subsystem 
and gives you a bearing when you find your¬ 
self in a part of Windows 95 that you never 
expected to end up in. 

Whether you want to dig in and learn 
Windows 95 inside out, or you want to 
be prepared for the nastiest Windows 
bugs, make Soft-ICE/WIN 95 a part of 
your tool kit. 


Nu-Mega 

TECHNOLOGIES INC 


WINDOWS 95 


4GB 


3GB 


2GB 


4MB 


VxDS 

Dynamic VxDs 


32-bit 

System DLLs 

16-bit 

Windows 

Applications 



Win32 

Applications 


System 

VM 


DOS 

Boxes 




Soft-ICE/WIN 95 is the 
only debugger that lets 
you debug VxDs at 
source level. 

You often have to step into 
the Windows 95 system DLLs 
to chase nasty bugs. When 
you do, make sure you have 
Soft-ICE/WIN 95 because your 
application debugger won't do. 


If you are chasing a bug that 
involves 16-bit and 32-bit code, 
Soft-ICE/WIN 95 will get you 
through the thunks at source level. 
Other debuggers can't. 


Your 32-bit application 
debugger leaves you 
trapped here. 


Soft-ICE/WIN 95 lets you 
switch address contexts so 
you can debug multiple 32-bit. 
applications simultaneously. 


Some of the most difficult bugs 
are the result of real mode 
programs, T&SRs or drivers. 
Soft-ICE/WIN 95 can debug 
these, as well as everything 
else in Windows 95. 


Windows 95: See It All! 
Get Soft-ICE/WIN 95 


ONLY 

$386! 


PLUS SHIPPING 


Call 1 -800-4-NU-MEGA 

(1-800-468-6342) 

RISK = NULL 30 DAY MONEY BACK GUARANTEE 


102 Perimeter Road Nashua, NH 03063 (603) 889-2386 Fax (603) 889-1135 info@numega.com 
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